§APIPublic API

Vibrako API v1

JSON, open CORS, no payment. Bearer token auth. 60 req/min/key default. Onboarding takes 5 minutes: request a key, add the header, done.

Request an API key

Email hola@vibrako.com with: your name, intended use, and whether you need a rate limit above 60 req/min. Key delivered within 24h.

§01Auth

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

Browser-friendly alternative: append ?api_key=vbk_live_<token> to the URL.

§02Endpoints

Method	Path	Scope	Description
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

§03Example: current Hot 100

{
  "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"
      }
    }
  ]
}

§04Errors

401 missing_or_invalid_token · Missing Authorization header or wrong format
401 unknown_token · Token unknown or revoked
403 missing_scope:<scope> · Key lacks that scope
429 rate_limited · Rate limit exceeded. Retry-After: 60
404 no_snapshot_yet · No data yet for that week or filter