> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/spotify>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/spotify.mdx>

---

# Spotify data API. Any artist, album or track.

Artists, albums and tracks by id or share URL, as JSON in one request. No Spotify developer app and no OAuth.

- No developer app
- Share URLs or IDs

Creator graphs often miss the Spotify artist ID behind a TikTok sound or pasted open.spotify.com link. Social Fetch exposes three GETs — artist, album, and track — by Spotify id or public URL. Every response uses `{ data, meta }` with `data.lookupStatus`, `meta.requestId`, and `meta.creditsCharged`.

## What you can get

- Artist cards by Spotify artist id or artist URL — display name, bio, followers, monthly listeners, related artists, discography counts.
- Album lookups with label, release date, cover art, credited artists, and an ordered tracklist.
- Track metadata — title, duration, album context, credited artists — from a track id or share link.
- Accept either a raw Spotify id or a public `open.spotify.com/{artist|album|track}/…` URL on each route.
- Same Social Fetch API key and response envelope as TikTok, YouTube, Instagram, and the rest of the marketplace.

## Spotify endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Artist | GET /v1/spotify/artist | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/spotify/artist/get) |
| Album | GET /v1/spotify/album | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/spotify/album/get) |
| Track | GET /v1/spotify/track | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/spotify/track/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits — enough to smoke-test artist, album, and track GETs against live catalog data.
2. **Call a Spotify route.** Send `GET /v1/spotify/artist` (or `/album`, `/track`) with `x-api-key` and either the entity id query param or a public Spotify URL. Use the TypeScript SDK or curl in production jobs; keep the playground for one-off checks in the app.
3. **Join music ids to social rows.** Branch on `data.lookupStatus` before writing. Persist the Spotify artist/album/track id on the same person or campaign record as TikTok and YouTube handles. Log `meta.requestId` for support; bill from `meta.creditsCharged`.

## Pricing

Spotify artist, album, and track routes charge 1 credit per successful completed lookup. Credits never expire on pay-as-you-go packs. Confirm every response with `meta.creditsCharged` — that field is the billing source of truth.

## Compared with the official API

Spotify Web API is for apps with developer credentials, rate limits, and user OAuth — playback, libraries, playlist management. Social Fetch routes are public catalog enrichment: id or URL in, JSON out, no Spotify developer app.

## FAQ

### Is there a Spotify scraper API / Spotify data API?

Yes. Social Fetch provides REST routes for public Spotify artists, albums, and tracks. Authenticate with a Social Fetch API key (`x-api-key`); you do not need a Spotify developer app for these public catalog lookups.

### What Spotify data does Social Fetch cover?

Three operations under the Spotify tag: `GET /v1/spotify/artist`, `GET /v1/spotify/album`, and `GET /v1/spotify/track`. Artist responses can include metrics (followers, monthly listeners), related artists, and discography counts. Album responses include release metadata and an ordered tracklist. Track responses include title, duration, album context, and credited artists. Exact fields are on each endpoint page and in `/docs/api`.

### Do I need a Spotify developer app or OAuth?

Not for Social Fetch public catalog routes. You only need a Social Fetch API key. Spotify Web API with a developer app and OAuth remains the path for playback, user libraries, and playlist write scopes.

### Can I access user playlists or listening history?

No. These routes return public catalog metadata only. Private libraries, recently played, and playlists you manage require Spotify's official Web API with the appropriate user scopes.

### What identifiers do Spotify routes accept?

Each route accepts either a Spotify entity id (`artistId`, `albumId`, or `trackId`) or a public `https://open.spotify.com/...` URL for that entity type. One identifier per request — do not send conflicting id and URL values on the same call.

### How much does the Spotify API cost on Social Fetch?

You buy credit packs (or use the 100 free signup credits). Artist, album, and track lookups cost 1 credit each on a successful completed request. There is no required monthly subscription for pay-as-you-go packs. Always check `meta.creditsCharged`.

### Spotify Web API vs Social Fetch — which should I use?

Use Spotify Web API when you need official quotas, playback, user-authorized features, or playlist management. Use Social Fetch when you want public artist/album/track enrichment without standing up a Spotify developer app, or when you already normalize social and music data through Social Fetch's shared envelope across platforms.

### Does HTTP 200 always mean the artist, album, or track was found?

No. HTTP 200 means the request finished. Check `data.lookupStatus`: `found` means you got catalog data; `not_found` means the id or URL did not resolve. Persist `meta.requestId` when you need to debug a miss.

### Can I use Spotify routes from agents or MCP?

Yes. The same operations appear as typed MCP tools and can be reached via Ask (`POST /v1/ask`) for plain-English exploration. For production jobs, pin the typed GET paths (`/v1/spotify/artist`, `/album`, `/track`) so routing stays explicit.

### Is scraping Spotify data legal?

Social Fetch returns publicly visible catalog data. You are responsible for how you use it under Spotify's terms, applicable law, and your own compliance review. We do not give legal advice.

## Related

- [Spotify Artist API](https://www.socialfetch.dev/platforms/spotify/artist): Resolve an artist by id or open.spotify.com/artist URL — metrics, related artists, discography counts.
- [Spotify Track API](https://www.socialfetch.dev/platforms/spotify/track): Track title, duration, album, and credited artists from a track id or share link.
- [Spotify Album API](https://www.socialfetch.dev/platforms/spotify/album): Release metadata plus an ordered tracklist for a public album id or URL.
- [Ask in plain English](https://www.socialfetch.dev/ask): POST /v1/ask routes a natural-language question to the matching Spotify or social operation.
- [Hosted MCP server](https://www.socialfetch.dev/mcp): Call the same Spotify tools from Cursor, VS Code, or Claude with OAuth — same credits as REST.
- [Creator intelligence use case](https://www.socialfetch.dev/use-cases/creator-intelligence-api): Join music catalog ids to multi-platform creator graphs.
- [TikTok API hub](https://www.socialfetch.dev/platforms/tiktok): Pair Spotify artist/track enrichment with TikTok profiles, videos, and sound-related workflows.
