# 2s Music Recording Search

> 2s Music Recording Search is a paid API for AI agents from 2s.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Search MusicBrainz for music recordings by artist name, song title, or free-text/Lucene query, returning MBIDs, durations, and release dates.

## Facts

- Endpoint: GET https://2s.io/api/music/recording
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-music-recording-search-c9594404
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9OlVSA42ssfmUzz3FEx2Q

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-music-recording-search-c9594404
```

Example prompt: Search MusicBrainz for recordings of 'Creep' by Radiohead and give me the MBID, track length, and first release date — return up to 5 results.

## When to prefer this

Use this endpoint when you need structured, authoritative music recording metadata including MBIDs, release dates, and track lengths from MusicBrainz. Prefer it over general web search when you need a canonical identifier (MBID) to link to other music APIs. It supports Lucene query syntax for advanced filtering, making it more powerful than simple name lookups.

## Known failure modes

- No results found when artist or title spelling is off — try alternate spellings or use the free-text query field
- Query too broad returns up to 25 results max — refine with artist+title combination
- Payment failure (402) if USDC balance is insufficient
- Rate limiting or upstream MusicBrainz unavailability returning non-200 response

## How this service works

Resolve a song/recording from MusicBrainz (the open, CC0 music encyclopedia). Pass artist + title, or a free-text query (Lucene supported). Returns ranked recordings with MusicBrainz ID (MBID), title, primary artist, length (ms), first-release date, and disambiguation. Keyless, public-domain core data. Use to canonicalize a track to its MBID or cross-reference identity.

## Output

Returns a JSON array of matching recordings, each with a MusicBrainz ID (mbid), relevance score, title, artist, length in milliseconds, first release date, and optional disambiguation string. Also includes total match count and source/license attribution pointing back to MusicBrainz.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 25,
       "minimum": 1
      },
      "query": {
       "type": "string",
       "description": "Free-text / Lucene query (overrides artist+title)."
      },
      "title": {
       "type": "string"
      },
      "artist": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-music-recording-search-c9594404/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)