HabboLibre

API pública de HabboLibre

Endpoints REST públicos: hoteles, noticias, foro, presencia y feeds. Sin autenticación a menos que se indique.

Feed RSS Vote callback Hotel presence
URL base

Todas las rutas se prefijan con https://api.habbolibre.org/api/v1. Las respuestas son JSON salvo cuando se indique. Las rutas marcadas con Auth requieren Sanctum o Bearer pingback_secret.

Rate-limit: la mayoría de endpoints están limitados a 60 req/min por IP.

Hoteles
  • GET/hotels

    Listado paginado de hoteles aprobados.

    per_page, page, search, category, tag, featured, online, has_users_online, sort=(votes|newest|name|online_users)

  • GET/hotels/{slug}

    Detalle de un hotel.

  • GET/hotels/{slug}/stats

    Estadísticas públicas: votos del mes, clics, uptime 7d/30d, sparkline 30d.

  • GET/hotels/{slug}/reviews

    Reseñas públicas paginadas, incluyendo respuesta del propietario.

  • GET/hotels/{slug}/similar

    Hasta 4 hoteles similares por categoría y tags compartidos.

  • GET/hotels/summary

    Resumen global: total, online ahora, usuarios online reportados.

  • POST/hotels/{slug}/presenceBearer

    Reporta usuarios online del hotel (cron desde tu CMS).

Noticias
  • GET/news

    Listado paginado de noticias publicadas.

    page, category

  • GET/news/{slug}

    Detalle de una noticia, incluye relacionadas.

  • POST/news/{slug}/view

    Registra una lectura (deduplicado por IP+UA durante 12h).

Foro
  • GET/forum/categories

    Estructura del foro: secciones, categorías y subforos.

  • GET/forum/categories/{slug}

    Temas paginados de una categoría.

  • GET/forum/topics/{slug}

    Tema con posts paginados.

  • GET/forum/search

    Buscar temas por título.

    q (mínimo 2 caracteres)

  • GET/forum/stats

    Estadísticas del foro y presencia online.

  • GET/forum/ranks

    Configuración de rangos del foro.

Comunidad y usuarios
  • GET/users/{name}/profile

    Perfil público + actividad reciente (votos, posts, hoteles, reseñas).

  • GET/community

    Listado de comunidad con presencia.

Otros
  • GET/settings/public

    Configuración pública del sitio (logo, título, colores).

  • GET/health

    Liveness probe.

  • GET/feeds/news.xml

    Feed RSS 2.0 de las últimas 20 noticias.

    (servido por Nuxt en habbolibre.org, no en api.)

Ejemplo

Listar los hoteles más votados del mes:

curl -s "https://api.habbolibre.org/api/v1/hotels?per_page=5&sort=votes" | jq '.data[] | {slug, name, monthly_votes_count}'