# Social Fetch API - Spotify endpoints
# Base URL: https://api.socialfetch.dev
# Auth: x-api-key header (sfk_...)
# Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json
# Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json

3 documented Spotify operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported.

## GET /v1/spotify/artist
Get Spotify artist
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/spotify/artist/get.mdx
SDK: client.spotify.getArtist({ artistId: "1uNFoZAHBGtllmzznpCI3s" })
Parameters:
- artistId (optional, string) - Optional Spotify artist id for the request.
- url (optional, string) - Optional Spotify artist URL for the request.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/spotify/artist?artistId=1uNFoZAHBGtllmzznpCI3s" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/spotify/album
Get Spotify album
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/spotify/album/get.mdx
SDK: client.spotify.getAlbum({ albumId: "0pgrg7phBbnwGJ2HBEl9EG" })
Parameters:
- albumId (optional, string) - Optional Spotify album id for the request.
- url (optional, string) - Optional Spotify album URL for the request.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/spotify/album?albumId=0pgrg7phBbnwGJ2HBEl9EG" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/spotify/track
Get Spotify track
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/spotify/track/get.mdx
SDK: client.spotify.getTrack({ trackId: "1ITJflybJsfarsUtiBvkfK" })
Parameters:
- trackId (optional, string) - Optional Spotify track id for the request.
- url (optional, string) - Optional Spotify track URL for the request.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/spotify/track?trackId=1ITJflybJsfarsUtiBvkfK" \
  -H "x-api-key: YOUR_API_KEY"