get_ranked_albums
albumoftheyear.orgRetrieves paginated critic-score, critic-review-count, or user-score album rankings for a year or all time from https://albumoftheyear.org. Each album includes rank, release date, genres, scores, artwork, listening links, and a detail path.
Playground
Runs on Notte and spends your workspace credits — what comes back is the live response, not a sample.
What is get_ranked_albums?
Retrieves paginated critic-score, critic-review-count, or user-score album rankings for a year or all time from https://albumoftheyear.org. Each album includes rank, release date, genres, scores, artwork, listening links, and a detail path. It runs on Notte's browser infrastructure and returns structured JSON, so you can call it like any other API — pass period, order_by, page and get the result back without maintaining a scraper.
Response
{
"page": 0,
"albums": [
{
"rank": 0,
"links": [
{
"url": "<string>",
"service": "<string>"
}
],
"score": 0,
"title": "<string>",
"artist": "<string>",
"must_hear": true,
"album_path": "<string>",
"score_type": "<string>",
"exact_score": 0,
"must_hear_by": [
"<string>"
],
"rating_count": 0,
"release_date": "<string>",
"display_title": "<string>",
"primary_genres": [
{
"name": "<string>",
"path": "<string>"
}
],
"cover_image_url": "<string>",
"secondary_genres": [
{
"name": "<string>",
"path": "<string>"
}
],
"rating_count_type": "<string>",
"cover_image_2x_url": "<string>"
}
],
"period": "<string>",
"has_next": true,
"order_by": "<string>",
"page_size": 0,
"total_pages": 0,
"has_previous": true
}Call it
curl --location 'https://us-prod.notte.cc/functions/f3feb873-d74b-42cb-b43e-6140eefcb19c/runs/start' \
--header 'x-notte-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
"function_id": "f3feb873-d74b-42cb-b43e-6140eefcb19c",
"variables": {
"period": "2025",
"order_by": "critic_score",
"page": 1
}
}'Ask an agent
Paste this into Claude Code, Cursor or any MCP client to have an agent call this function for you.
Use the Anything API MCP server (https://anything.notte.cc/mcp). Call run(function_id="f3feb873-d74b-42cb-b43e-6140eefcb19c") — the "get_ranked_albums" function, which retrieves paginated critic-score, critic-review-count, or user-score album rankings for a year or all time from https://albumoftheyear.org. Each album includes rank, release date, genres, scores, artwork, listening links, and a detail path.. It takes period (str), order_by (str), page (int). Return the result as structured JSON.