# StableMusic Track Search

> StableMusic Track Search is a paid API for AI agents from stablemusic.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Search for music tracks on Last.fm by query string, returning matching track results with artist and metadata.

## Facts

- Endpoint: POST https://stablemusic.dev/api/tracks/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stablemusic-track-search-1148ab75
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Qg27xLxjJFdI4cewZ2_rX

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 stablemusic-track-search-1148ab75 -d '<json body>'
```

Example prompt: Search StableMusic for tracks matching 'blue monday' and show me the top results with artist names and play counts.

## When to prefer this

Use this endpoint when you need to search for specific tracks by name or keyword against the Last.fm catalog, especially when you want pay-per-request pricing without a subscription. Prefer over direct Last.fm API when you need x402 micropayment-compatible music search.

## Known failure modes

- Empty search query returns error or empty results
- No matching tracks found returns empty list
- Last.fm API unavailable causes 502 or timeout
- Payment not included or insufficient returns 402 Payment Required
- Rate limit exceeded returns 429

## How this service works

Pay-per-request Last.fm music discovery for tags, tracks, artists, albums, charts, and country charts.

## Output

A list of matching tracks from Last.fm, each including track title, artist name, listener/playcount statistics, and a Last.fm URL for further details.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "page": {
   "type": "integer",
   "default": 1,
   "maximum": 9007199254740991,
   "minimum": 1,
   "description": "Last.fm page number. Defaults to 1."
  },
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 100,
   "minimum": 1,
   "description": "Number of results to return. Defaults to 10, max 100."
  },
  "track": {
   "type": "string",
   "minLength": 1,
   "description": "Track search query."
  },
  "artist": {
   "type": "string",
   "minLength": 1,
   "description": "Optional artist hint used to filter/clarify the query."
  },
  "include_raw": {
   "type": "boolean",
   "default": false,
   "description": "Include the upstream Last.fm response payload."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablemusic-track-search-1148ab75/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablemusic.dev](https://www.zero.xyz/host/stablemusic.dev/llms.txt)