# Spotify Scraper API (x402)

> Spotify Scraper API (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured metadata from public Spotify URLs or URIs (artists, albums, tracks, playlists, shows, episodes) for a flat $0.025 USDC pay-per-call fee.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/spotify?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/spotify-scraper-api-x402-8fbd6733
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QZttM9y4AoxPzcwnwUiIX

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 spotify-scraper-api-x402-8fbd6733 -d '<json body>'
```

Example prompt: Can you pull the structured metadata — name, artist, image URL, and type — from these three Spotify URLs: https://open.spotify.com/track/abc123, https://open.spotify.com/album/def456, and https://open.spotify.com/artist/ghi789?

## When to prefer this

Use this endpoint when you need structured Spotify metadata (track, album, artist, playlist, podcast) from known public URLs or URIs without needing a Spotify developer API key. Ideal for agents that encounter Spotify links in user input and need to enrich them with structured data. Prefer this over the official Spotify API when you lack OAuth credentials or want simple pay-per-call billing with no monthly quota. Not suitable for keyword search or catalog browsing.

## Known failure modes

- Invalid or non-public Spotify URL — returns empty items array, not charged
- Spotify page structure changes breaking the scraper — may return nulls for some fields
- Exceeding maxResults cap of 1000 — results truncated to limit
- Network/scraping timeout — likely returns error, not charged per policy
- Spotify URI vs URL confusion — ensure correct format is passed

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count and an items array. Each item includes: id (Spotify ID), uri (Spotify URI), url (canonical Spotify URL), name (title), type (artist/album/track/playlist/show/episode), artist (primary artist string), artists (array of artists if applicable), and imageUrl (cover/profile image). Failed or empty runs are not billed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "urls"
   ],
   "type": "string",
   "default": "urls",
   "description": "Use direct URL scraping. Keyword search is temporarily unavailable because the public catalog endpoint rejects anonymous requests."
  },
  "urls": {
   "type": "array",
   "description": "Public artist, album, track, playlist, show, or episode URLs or Spotify URIs. Each URL produces one record."
  },
  "maxResults": {
   "type": "integer",
   "default": 50,
   "maximum": 1000,
   "minimum": 1,
   "description": "Maximum number of URL records emitted in this run."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "uri": null,
    "url": null,
    "name": null,
    "type": null,
    "artist": null,
    "artists": null,
    "imageUrl": null
   }
  ],
  "product": "spotify"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/spotify-scraper-api-x402-8fbd6733/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)