Live

search_albums

albumoftheyear.org

Searches album titles and artist names on https://albumoftheyear.org and returns relevance-ordered, paginated album results with release metadata, artwork, and detail paths.

Music

Parameters2

Runs10

Updated10d ago

Operational10 runs · 100% succeeded

30 days ago90 days agoranfailednot checkedtoday

Playground

GETsearch_albums GETget_ranked_albums GETlist_genres GETget_album_metadata

Runs on Notte and spends your workspace credits — what comes back is the live response, not a sample.

Parameters

querystr= Radiohead

pageint= 1

Need another parameter? Ask the agent →

Waiting on your first callSet the parameters on the left and test it — the real response shows up right here.

What is search_albums?

Searches album titles and artist names on https://albumoftheyear.org and returns relevance-ordered, paginated album results with release metadata, artwork, and detail paths. It runs on Notte's browser infrastructure and returns structured JSON, so you can call it like any other API — pass query, page and get the result back without maintaining a scraper.

Response

{
  "page": 0,
  "query": "<string>",
  "results": [
    {
      "title": "<string>",
      "artist": "<string>",
      "position": 0,
      "must_hear": true,
      "album_path": "<string>",
      "artist_path": "<string>",
      "must_hear_by": [
        "<string>"
      ],
      "release_type": "<string>",
      "release_year": "<string>",
      "cover_image_url": "<string>",
      "cover_image_2x_url": "<string>"
    }
  ],
  "has_next": true,
  "page_size": 0,
  "total_pages": 0,
  "has_previous": true,
  "total_results": 0
}

Call it

curl --location 'https://us-prod.notte.cc/functions/83196ef5-a0cd-4133-a92c-19b868296faa/runs/start' \
--header 'x-notte-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
    "function_id": "83196ef5-a0cd-4133-a92c-19b868296faa",
    "variables": {
        "query": "Radiohead",
        "page": 1
    }
}'

Ask an agent

Paste this into Claude Code, Cursor or any MCP client to have an agent call this function for you.

prompt

Use the Anything API MCP server (https://anything.notte.cc/mcp).

Call run(function_id="83196ef5-a0cd-4133-a92c-19b868296faa") — the "search_albums" function, which searches album titles and artist names on https://albumoftheyear.org and returns relevance-ordered, paginated album results with release metadata, artwork, and detail paths..

It takes query (str), page (int). Return the result as structured JSON.