rateyourmusic.com APIrateyourmusic.com ↗
Access RateYourMusic album ratings, artist discographies, genre hierarchies, and top/bottom charts via 6 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/4543201b-0c81-4415-b1a4-83478db54412/get_charts?page=1&year=all-time&chart_type=top&media_type=album' \ -H 'X-API-Key: $PARSE_API_KEY'
Extract charts data for albums or tracks. Returns paginated results with 40 items per page. Supports filtering by media type, chart type, year, and pagination.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-indexed). |
| year | string | Year or year range (e.g. 2024, 2020-2024, all-time). |
| chart_type | string | Type of chart. Accepted values: top, bottom. |
| media_type | string | Type of media. Accepted values: album, track, ep, single. |
{
"type": "object",
"fields": {
"items": "array of chart entries with rank, release_name, artist, date, release_type, genres, rating info",
"total": "integer count of items returned on this page"
},
"sample": {
"data": {
"items": [
{
"date": "15 March 2015",
"rank": 1,
"artist": "Kendrick Lamar",
"rating": "4.38",
"artist_url": "https://rateyourmusic.com/artist/kendrick-lamar",
"release_url": "https://rateyourmusic.com/release/album/kendrick-lamar/to-pimp-a-butterfly/",
"release_name": "To Pimp a Butterfly",
"release_type": "Album",
"ratings_count": "105k",
"reviews_count": "1k",
"primary_genres": [
"Conscious Hip Hop",
"Jazz Rap"
],
"secondary_genres": [
"Political Hip Hop",
"Neo-Soul"
]
}
],
"total": 40
},
"status": "success"
}
}About the rateyourmusic.com API
The Rate Your Music API gives developers structured access to RYM's music catalog across 6 endpoints, covering release details, artist discographies, genre hierarchies, and paginated chart data. The get_charts endpoint lets you pull ranked albums, EPs, singles, and tracks filtered by chart type and year, while get_release_details returns tracklists, descriptors, average ratings, and genre tags for any release.
Release and Artist Data
The get_release_details endpoint accepts a release URL path and returns the title, artist, genres array, descriptors array, tracklist, average rating, and rating count. The get_artist_details endpoint takes an artist URL path and returns the artist's name, associated genres, and a full discography array — each entry includes the release title, URL, year, average rating, and ratings count.
Charts
The get_charts endpoint returns paginated chart results — 40 items per page — filterable by media_type (album, track, EP, or single), chart_type (top or bottom), and year (a single year like 2024, a range like 2020-2024, or all-time). Each chart entry includes rank, release name, artist, release date, release type, genres, and rating information. Use the page parameter to step through results.
Genre Hierarchy
The get_genres endpoint returns a flat list of all genres available on RYM, each with a name and URL. The get_genre_details endpoint accepts a genre URL path and returns the genre name, its description text, and an array of parent genre names, exposing the full hierarchical relationship between genres.
Search
The search endpoint accepts a query string and an optional search_type filter (all, a for artists, l for releases, or g for genres). Results return an array of objects, each with a name, URL, and type field (artist, release, genre, or other), making it straightforward to feed results into the detail endpoints.
- Build a music recommendation tool that surfaces top-rated albums by genre using
get_chartsfiltered bymedia_typeandyear. - Aggregate an artist's full discography with ratings and release years via
get_artist_details. - Construct a genre taxonomy or knowledge graph using parent-child relationships from
get_genre_details. - Track chart position trends for a specific release type (EP, single) across multiple years.
- Display tracklists and descriptors for releases in a music cataloging application using
get_release_details. - Search RYM's catalog by keyword and type to resolve artist or album names to canonical URLs.
- Analyze bottom-rated releases in a given year using the
chart_type=bottomfilter onget_charts.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Rate Your Music have an official developer API?+
What does `get_charts` return and how do I filter it?+
media_type (album, track, ep, single), chart_type (top or bottom), and year (e.g. 2024, 2020-2024, or all-time). Use the page parameter to paginate through results.Does the API expose user review text or individual user ratings?+
Are lists (user-curated or official RYM lists) accessible through this API?+
What is a limitation to be aware of when using genre data?+
get_genre_details returns parent genre names as strings, not URLs or IDs, so traversing the full hierarchy requires first resolving parent names to URLs using the get_genres endpoint. Also, genre descriptions may be absent for less-documented genres.