# Spotify Play Data Scraper

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

Extracts structured track, album, artist, and listener data from public Spotify URLs

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/spotify-play?utm_source=zero.xyz
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/spotify-play-data-scraper-e1f96159
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_p6laRDAgWd2KNFvANUAi9

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-play-data-scraper-e1f96159 -d '<json body>'
```

Example prompt: Pull the monthly listeners, follower count, and verified status for these three Spotify artist pages: spotify.com/artist/abc, spotify.com/artist/def, spotify.com/artist/ghi — and also grab their albums and the tracks from each.

## When to prefer this

Choose this endpoint when you need structured, pay-per-call extraction of public Spotify metadata — artist stats, track listings, follower counts — without managing a scraping infrastructure. Especially useful for bulk runs across mixed URL types (artist, album, track) in a single call, and when you only want to pay for successful results.

## Known failure modes

- Private or unavailable Spotify URLs return empty result sets (no charge)
- Invalid URL format may result in zero items returned
- Rate limits or Spotify access restrictions may cause partial results
- maxItems=0 returns all rows which may be very large for prolific artists
- followAlbums/followSingles flags on non-artist URLs have no effect

## 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 of items and an array of track/artist rows, each containing artistId, artistUrl, artistName, followers, monthlyListeners, artistVerified, sourceUrl, and sourceType fields. Failed or empty runs are not billed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "urls": {
   "type": "array",
   "description": "Public Spotify artist, album, and track URLs. Mix URL types in one run."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Maximum number of track rows across all URLs. Zero means no limit."
  },
  "followAlbums": {
   "type": "boolean",
   "default": false,
   "description": "For artist URLs, fetch the albums listed in the public artist overview and output their tracks."
  },
  "followSingles": {
   "type": "boolean",
   "default": false,
   "description": "For artist URLs, fetch the first ten singles listed in the public artist overview."
  },
  "scrapePreviewUrls": {
   "type": "boolean",
   "default": false,
   "description": "Also fetch public preview URLs when available; stream counts remain included."
  },
  "followPopularReleases": {
   "type": "boolean",
   "default": false,
   "description": "For artist URLs, fetch the first ten popular releases listed in the public artist overview."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "artistId": null,
    "artistUrl": null,
    "followers": null,
    "sourceUrl": null,
    "artistName": null,
    "sourceType": null,
    "artistVerified": null,
    "monthlyListeners": null
   }
  ],
  "product": "spotify-play"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/spotify-play-data-scraper-e1f96159/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)