§APIAPI publica

Vibrako API v1

JSON, CORS abierto, sin pagar. Auth por bearer token. 60 req/min/key por defecto. Empezar es 5 minutos: pides una key, la pones en el header, listo.

Pedir una API key

Escribe a hola@vibrako.com con: tu nombre, el caso de uso, y si necesitas un rate limit superior a 60 req/min. Devolvemos la key en 24h.

§01Auth

curl -H "Authorization: Bearer vbk_live_<token>" \
     https://vibrako.com/api/v1/hot100

Alternativa para test rapido en navegador: anade ?api_key=vbk_live_<token> al final de la URL.

§02Endpoints

Method	Path	Scope	Descripcion
GET	/api/v1	public	Endpoint index + metadata
GET	/api/v1/meta	read:meta	Counts (posts, artists, tracks, playlists, hot100 snapshots) + Hot 100 latest week + weights
GET	/api/v1/hot100	read:hot100	Current Hot 100 snapshot (up to 100 ranked entries)
GET	/api/v1/hot100/week/{weekIso}	read:hot100	Historical week, ej. 2026-W20
GET	/api/v1/hot100/weeks?limit=60	read:hot100	List available weeks
GET	/api/v1/hot100/genre/{slug}	read:hot100	Hot 100 filtered by genre slug (reggaeton, urbano-latino, regional-mexicano, ...)
GET	/api/v1/hot100/platform/{platform}	read:charts	Sub-chart per platform (spotify, youtube, tiktok)
GET	/api/v1/charts/{platform}/{country}	read:charts	Latest snapshot for a platform+country (ES, MX, AR, CO, CL, US, GLOBAL)
GET	/api/v1/artists?limit=60	read:artists	List artists with bio + genres + cover
GET	/api/v1/artists/{slug}	read:artists	Artist detail + chart history
GET	/api/v1/tracks/{slug}	read:tracks	Track detail + chart history + writers/producers/label
GET	/api/v1/playlists	read:playlists	List published Spotify playlists
GET	/api/v1/playlists/{slug}	read:playlists	Playlist detail + tracks
GET	/api/v1/search?q=...&locale=es	read:search	Search across posts, playlists, artists, genres, festivals, venues, cities

§03Ejemplo: Hot 100 actual

{
  "week_iso": "2026-W20",
  "week_start": "2026-05-11",
  "generated_at": "2026-05-13T08:42:11.000Z",
  "locked": false,
  "entries": [
    {
      "rank": 1,
      "last_week": null,
      "peak": 1,
      "weeks_on_chart": 1,
      "debut_week_iso": "2026-W20",
      "score": 0.644231,
      "badges": ["new"],
      "track": {
        "slug": "quevedo-al-golpito",
        "title": "AL GOLPITO",
        "artist_name": "Quevedo",
        "artist_slug": "quevedo",
        "features": [],
        "cover": "https://image-cdn-fa.spotifycdn.com/...",
        "spotify_id": "6LD1tYOKReFqZh5ZdCdxIz",
        "youtube_id": null,
        "url": "https://vibrako.com/es/canciones/quevedo-al-golpito"
      }
    }
  ]
}

§04Errores

401 missing_or_invalid_token · Falta header Authorization o el formato no es vbk_...
401 unknown_token · Token no existe o fue revocado
403 missing_scope:<scope> · La key no tiene ese scope
429 rate_limited · Pasaste el rate limit. Header Retry-After: 60
404 no_snapshot_yet · Aun no hay datos para esa semana o filtro