# Spotify Structured Data Scraper

> Spotify Structured Data Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Fetches structured metadata for Spotify artists, albums, tracks, playlists, shows, and episodes from public URLs or URIs

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/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-structured-data-scraper-f21f1e82
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5375uxq25rErwJ2iQg7Ue

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-structured-data-scraper-f21f1e82 -d '<json body>'
```

Example prompt: Can you pull the structured metadata — name, artist, image URL, and Spotify URI — for these three tracks: https://open.spotify.com/track/4uLU6hMCjMI75M1A2tKUQC, https://open.spotify.com/track/3n3Ppam7vgaVa1iaRUIOKE, and https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b?

## When to prefer this

Use this endpoint when you need structured Spotify metadata (names, artists, images, URIs) for known Spotify URLs without needing the official Spotify API credentials. Ideal for bulk enrichment of existing Spotify link collections, playlist analysis, or when you cannot use the Spotify Web API directly. Prefer this over manual scraping or the official API when you want pay-per-call simplicity with no auth setup.

## Known failure modes

- Empty items array if Spotify URL is private or requires login
- Null fields for metadata that Spotify does not expose publicly
- Request fails if URLs are malformed or not valid Spotify URLs/URIs
- Rate limiting or blocking by Spotify may return empty results
- maxResults cap of 1000 may truncate large playlists

## 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 contains the Spotify ID, URI, URL, name, type (track/album/artist/playlist/show/episode), primary artist, full artists list, and image URL. 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-structured-data-scraper-f21f1e82/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)