Spotify

Artist / Album / Track

per_call

One endpoint for the three core Spotify catalog objects. Artists return followers, genres, popularity, artwork, top tracks and albums; albums return label, release date, total tracks and the ordered track list; tracks return duration, explicit flag, popularity, playcount and the parent album. Built for A&R teams, label marketing and artist analytics dashboards.

Endpoint

GET /v1/spotify/artist-album-track

Price

$1.50

per 1,000 calls · $0.0015 per call

Cost per call

1 credit

Failed calls never charged

Parameters

optional

string

The Spotify artist, album or track ID. Required unless `url` is supplied.

url

optional

string

The public Spotify artist, album or track URL. Required unless `id` is supplied.

Example request

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

curl

curl "https://api.fastfetchz.com/v1/spotify/artist-album-track?id=0OdUWJ0sBjDrqHygGUXeCF" \
  -H "X-API-Key: $FASTFETCHZ_KEY"

Example response

200 application/json

{
  "success": true,
  "service": {
    "platform": "Spotify",
    "name": "Artist / Album / Track",
    "slug": "artist-album-track"
  },
  "credits_charged": 1,
  "credits_remaining": 99,
  "latency_ms": 214,
  "data": {
    "artist": {
      "id": "0OdUWJ0sBjDrqHygGUXeCF",
      "name": "Bon Iver",
      "genres": [
        "indie folk",
        "chamber pop"
      ],
      "popularity": 71,
      "followers": 3142880,
      "image_url": "https://cdn.example.com/spotify/artist/boniver.jpg",
      "external_url": "https://open.spotify.com/artist/0OdUWJ0sBjDrqHygGUXeCF",
      "top_tracks": [
        {
          "id": "2Ch7LmS7r2Gy2kc64wv3Bz",
          "name": "Skinny Love",
          "duration_ms": 238000,
          "popularity": 74
        },
        {
          "id": "6ItRxKGaOdQFPjRoSJHOxo",
          "name": "Holocene",
          "duration_ms": 337000,
          "popularity": 72
        }
      ],
      "albums": [
        {
          "id": "1MDoll0LEdz6E1s25Non7l",
          "name": "22, A Million",
          "release_date": "2016-09-30",
          "total_tracks": 10
        }
      ]
    },
    "album": {
      "id": "1MDoll0LEdz6E1s25Non7l",
      "name": "For Emma, Forever Ago",
      "label": "Jagjaguwar",
      "release_date": "2008-02-19",
      "total_tracks": 9,
      "image_url": "https://cdn.example.com/spotify/album/foremma.jpg",
      "tracks": [
        {
          "track_number": 1,
          "id": "6vGZ1nJWCHsPKlLZKMTU4s",
          "name": "Flume",
          "duration_ms": 199000,
          "explicit": false
        },
        {
          "track_number": 2,
          "id": "3PhoLpVuITZKcymswpck5b",
          "name": "Lump Sum",
          "duration_ms": 201000,
          "explicit": false
        }
      ]
    },
    "track": {
      "id": "6vGZ1nJWCHsPKlLZKMTU4s",
      "name": "Flume",
      "duration_ms": 199000,
      "explicit": false,
      "popularity": 62,
      "playcount": 48120774,
      "album": {
        "id": "1MDoll0LEdz6E1s25Non7l",
        "name": "For Emma, Forever Ago"
      },
      "artists": [
        {
          "id": "0OdUWJ0sBjDrqHygGUXeCF",
          "name": "Bon Iver"
        }
      ]
    },
    "requested": "nasa"
  }
}

Error codes

StatusCodeMeaning

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.