Live

search_releases

api.discogs.com

Searches releases on https://api.discogs.com with optional artist, label, year and format filters, returning complete non-empty result records across pages.

Marketplace Developer Tools

Parameters9

Runs6

Updated3d ago

Operational6 runs · 100% succeeded

30 days ago90 days agoranfailednot checkedtoday

Playground

GETsearch_releases GETlist_artist_releases GETlist_label_releases GETget_release_details

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

Parameters

querystr= Nirvana

artiststr

labelstr

yearint= 0

formatstr

start_pageint= 1

per_pageint= 25

max_pagesint= 2

timeout_secondsint= 20

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_releases?

Searches releases on https://api.discogs.com with optional artist, label, year and format filters, returning complete non-empty result records across pages. It runs on Notte's browser infrastructure and returns structured JSON, so you can call it like any other API — pass query, artist, label, year, format, start_page, per_page, max_pages, timeout_seconds and get the result back without maintaining a scraper.

Response

{
  "results": [
    {}
  ],
  "end_page": 0,
  "per_page": 0,
  "next_page": 0,
  "start_page": 0,
  "pages_fetched": 0,
  "source_total_items": 0,
  "source_total_pages": 0
}

Call it

curl --location 'https://us-prod.notte.cc/functions/895e1816-8e50-4126-b0f5-e81d11899383/runs/start' \
--header 'x-notte-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
    "function_id": "895e1816-8e50-4126-b0f5-e81d11899383",
    "variables": {
        "query": "Nirvana",
        "artist": "",
        "label": "",
        "year": 0,
        "format": "",
        "start_page": 1,
        "per_page": 25,
        "max_pages": 2,
        "timeout_seconds": 20
    }
}'

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="895e1816-8e50-4126-b0f5-e81d11899383") — the "search_releases" function, which searches releases on https://api.discogs.com with optional artist, label, year and format filters, returning complete non-empty result records across pages..

It takes query (str), artist (str), label (str), year (int), format (str), start_page (int), per_page (int), max_pages (int), timeout_seconds (int). Return the result as structured JSON.