# Spotify Track API (https://www.socialcrawl.dev/platforms/spotify/track)

> Returns track metadata — artists, album info, duration, playability, and sharing details. Pass either `id` or `url`.

TL;DR: `GET /v1/spotify/track` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | no | Spotify track ID. |
| `url` | no | Spotify track URL. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/spotify/track" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get Spotify track data with an API?

Send a GET request to /v1/spotify/track with either an id or url parameter. The response includes the track's artists, album info, duration, playability, and sharing details in unified JSON.

### What fields does the Spotify Track API return?

Each track response carries the title, contributing artists, album metadata, duration, playability status, and share links, mapped to the unified Post schema SocialCrawl uses across 40+ platforms.

### Can I pass a Spotify track URL instead of an ID?

Yes. Pass either the track ID or the full open.spotify.com/track URL. The endpoint accepts both, so you can feed it links straight from playlists or share buttons.

### How much does the Spotify Track API cost?

Each request costs 1 credit on the standard tier. New accounts get 100 free credits with no credit card required, so you can fetch about 100 tracks before paying anything.

### Do I need OAuth to fetch Spotify track metadata?

No. SocialCrawl handles upstream access for you. One x-api-key header replaces Spotify's app registration, token exchange, and refresh cycle entirely.

See the full Spotify API: https://www.socialcrawl.dev/platforms/spotify

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to fetch Spotify track metadata with an API
- What does the SocialCrawl Spotify Track API return?