FastFetchz
Spotify

Spotify

Search

per_call

Runs a single Spotify catalog search and returns matches grouped by entity type, each with its ID, name, artwork and the popularity or follower signals available for that type. Ideal for catalog matching, building music discovery features and resolving messy artist or track names into stable Spotify IDs.

Endpoint

GET /v1/spotify/search

Price

$1.50

per 1,000 calls · $0.0015 per call

Cost per call

1 credit

Failed calls never charged

Parameters

query
required
string

Keyword to search across albums, artists, playlists, podcasts and tracks.

Example request

Sandbox calls return deterministic sample data in the live payload shape.

curl
curl "https://api.fastfetchz.com/v1/spotify/search?query=bad%20bunny" \
  -H "X-API-Key: $FASTFETCHZ_KEY"

Example response

200 application/json
{
  "success": true,
  "service": {
    "platform": "Spotify",
    "name": "Search",
    "slug": "search"
  },
  "credits_charged": 1,
  "credits_remaining": 99,
  "latency_ms": 214,
  "data": {
    "query": "nasa",
    "artists": [
      {
        "id": "4q3ewBCX7sLwd24euuV69X",
        "name": "Bad Bunny",
        "followers": 84120331,
        "popularity": 95
      }
    ],
    "albums": [
      {
        "id": "5rjWDeTUfDsUXHNjcqvbNv",
        "name": "DeBÍ TiRAR MáS FOToS",
        "release_date": "2025-01-05",
        "total_tracks": 17
      }
    ],
    "tracks": [
      {
        "id": "2plbrEY59IikOBgBGLjaoe",
        "name": "DtMF",
        "duration_ms": 236000,
        "popularity": 91
      }
    ],
    "playlists": [
      {
        "id": "37i9dQZF1DX10zKzsJ2jva",
        "name": "Viva Latino",
        "followers": 14902112
      }
    ],
    "podcasts": [
      {
        "id": "0LqiOSKjqZgYWvUdUHYFTL",
        "name": "Sandbox Music Podcast",
        "publisher": "Sandbox Media"
      }
    ],
    "episodes": [
      {
        "id": "3nQm1E9dSlZ4Wc9jvV0nGT",
        "name": "Sandbox episode",
        "duration_ms": 2940000
      }
    ]
  }
}

Error codes

401invalid_api_keyMissing or unrecognized X-API-Key header. No credits are charged.
402insufficient_creditsYour balance is below the cost of the call. Top up to continue.
403account_suspended / key_revokedThe account is suspended or the key was revoked.
429rate_limitedThe key exceeded its monthly cap or the burst limit. Retry later.
500upstream_errorUnexpected failure while fulfilling the request. Not charged.