# Spotify Play Stats Scraper (x402)

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

Scrapes public Spotify artist, album, and track data including play counts, follower counts, and monthly listeners from public Spotify URLs.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/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-stats-scraper-x402-dee77fe1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xJ6hhkTz26XKCT6qGXc6a

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-stats-scraper-x402-dee77fe1 -d '<json body>'
```

Example prompt: Scrape the Spotify stats for these three artists — Taylor Swift, Drake, and Billie Eilish — including their monthly listeners and follower counts, and also pull the tracks from their albums listed on their public overview pages.

## When to prefer this

Choose this endpoint when you need structured, pay-per-call scraping of public Spotify data — artist stats, monthly listeners, follower counts, and track listings — without paying for failed runs. Ideal for music analytics pipelines, label dashboards, or competitive research where you need bulk data from multiple Spotify URL types in one call.

## Known failure modes

- Private or region-locked Spotify URLs return empty results and are not charged
- Invalid or malformed Spotify URLs may cause empty item arrays
- Rate limiting or Spotify blocking may result in failed runs (not charged)
- maxItems set too low may truncate results unexpectedly
- Artist URLs without public album listings will not yield track data unless followAlbums is enabled

## How this service works

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

## Output

A JSON object with a count of returned items and an array of track/artist records, each containing fields like artistId, artistUrl, artistName, followers, monthlyListeners, artistVerified, sourceUrl, sourceType, and optionally preview URLs. 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-stats-scraper-x402-dee77fe1/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)
