Rankd for Developers
Rankd API
Rankd’s public API gives you what the Rankd community is rating: weekly charts, public profiles, ratings, reviews and lists, and albums, songs and artists with their community scores. It is read-only, it returns JSON, and it needs no API key.
Base URL
https://api.rankdmusic.app/v1curl "https://api.rankdmusic.app/v1/charts?type=album&limit=3"const response = await fetch('https://api.rankdmusic.app/v1/charts?type=album&limit=3');
const { data } = await response.json();
for (const entry of data.entries) {
console.log(entry.rank, entry.music.title, entry.community.average);
}What you can build#
Charts and discovery
The community’s weekly chart for albums, songs, artists and music videos, plus what is trending right now.
Music pages
Any album, song or artist from Apple Music, with its Rankd average, rating spread and public reviews.
Profiles
A person’s public profile, their pinned favourites, and every rating, review and list they have made public.
Lists and reviews
Public ranked lists and collections, entry by entry, and public reviews.
At a glance#
| Base URL | https://api.rankdmusic.app/v1 |
|---|---|
| Format | JSON, UTF-8. Timestamps are ISO 8601 in UTC. |
| Authentication | None for the 18 public endpoints. Why |
| Methods | GET only. |
| Rate limit | 60 requests a minute for each IP address. Details |
| Pagination | Cursors. Details |
| Browsers | The API does not send CORS headers, so call it from your server or app, not from a web page on another site. Details |
| OpenAPI | /openapi.json (OpenAPI 3.1) |
Next steps#
- Quickstart: from a username to their ratings, in four requests.
- API reference: every endpoint, with a live Try it panel.
- Models: every object the API returns.