Apple Music

Search

per_call

Searches the Apple Music catalog and returns matches per entity type with IDs, names, artwork and store URLs, optionally narrowed to a single type. Useful for cross-platform catalog matching and for enriching a music dataset that already has Spotify identifiers.

Endpoint

GET /v1/apple-music/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 Apple Music catalog entities.

type

optional

enum

Restrict results to a single entity type. Defaults to all.

One of: all, song, album, artist, playlist, station, music_video

Example request

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

curl

curl "https://api.fastfetchz.com/v1/apple-music/search?query=tame%20impala" \
  -H "X-API-Key: $FASTFETCHZ_KEY"

Example response

200 application/json

{
  "success": true,
  "service": {
    "platform": "Apple Music",
    "name": "Search",
    "slug": "search"
  },
  "credits_charged": 1,
  "credits_remaining": 99,
  "latency_ms": 214,
  "data": {
    "query": "nasa",
    "songs": [
      {
        "id": "1440833098",
        "name": "The Less I Know the Better",
        "artist": "Tame Impala",
        "duration_ms": 216000
      }
    ],
    "albums": [
      {
        "id": "1440832989",
        "name": "Currents",
        "artist": "Tame Impala",
        "release_date": "2015-07-17"
      }
    ],
    "artists": [
      {
        "id": "156458143",
        "name": "Tame Impala",
        "genres": [
          "Alternative"
        ]
      }
    ],
    "playlists": [
      {
        "id": "pl.u-sandbox",
        "name": "Psych Rock Essentials",
        "curator": "Apple Music"
      }
    ],
    "stations": [
      {
        "id": "ra.sandbox",
        "name": "Tame Impala Station"
      }
    ],
    "music_videos": [
      {
        "id": "1445010203",
        "name": "Borderline",
        "duration_ms": 240000
      }
    ]
  }
}

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.