# SocialCrawl API — spotify endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/spotify

## GET /v1/spotify/artist
Get a Spotify artist
Credit cost: 1 (standard)
Parameters:
- id (optional, string) — Spotify artist ID.
- url (optional, string) — Spotify artist URL.
- Constraint: one of id, url (at least one required)
curl "https://www.socialcrawl.dev/v1/spotify/artist" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/spotify/track
Get a Spotify track
Credit cost: 1 (standard)
Parameters:
- id (optional, string) — Spotify track ID.
- url (optional, string) — Spotify track URL.
- Constraint: one of id, url (at least one required)
curl "https://www.socialcrawl.dev/v1/spotify/track" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/spotify/album
Get a Spotify album
Credit cost: 1 (standard)
Parameters:
- id (optional, string) — Spotify album ID.
- url (optional, string) — Spotify album URL.
- Constraint: one of id, url (at least one required)
curl "https://www.socialcrawl.dev/v1/spotify/album" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/spotify/search
Search Spotify
Credit cost: 1 (standard)
Parameters:
- query (required) — Search query.
curl "https://www.socialcrawl.dev/v1/spotify/search?query=my first million" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/spotify/podcast
Get a Spotify podcast
Credit cost: 1 (standard)
Parameters:
- id (optional, string) — Spotify podcast (show) ID.
- url (optional, string) — Spotify podcast (show) URL.
- Constraint: one of id, url (at least one required)
curl "https://www.socialcrawl.dev/v1/spotify/podcast" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/spotify/podcast/episodes
List a Spotify podcast's episodes
Credit cost: 1 (standard)
Parameters:
- id (optional, string) — Spotify podcast (show) ID.
- url (optional, string) — Spotify podcast (show) URL.
- cursor (optional, integer) — Cursor returned by the previous response. Omit for page 1.
- Constraint: one of id, url (at least one required)
curl "https://www.socialcrawl.dev/v1/spotify/podcast/episodes" \
  -H "x-api-key: sc_your_api_key_here"