UnifAPI Docs

Search the Apple Music catalog

Searches the Apple Music catalog by keyword and returns matching artists, albums, songs, playlists, stations, music videos and radio episodes.

Pricing — $ · min $0.003

Minimum 3 credits ($0.003) per call. Records returned above the minimum bill 1 credit ($0.001) each.

GET
/apple-music/search

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Query Parameters

query*string

Search query text for Apple Music catalog results.

Length1 <= length <= 512
type?string

Catalog result type to return. Omit to search across types (treated as all).

Value in

  • "all"
  • "song"
  • "album"
  • "artist"
  • "playlist"
  • "station"
  • "music_video"
  • "radio_episode"

Header Parameters

Unifapi-Version?"2026-07-01"

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Default"2026-07-01"

Value in

  • "2026-07-01"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/apple-music/search?query=string"
{  "request_id": "string",  "data": {    "query": "string",    "type": "string",    "artists": [      {        "artist_id": "string",        "display_name": "string",        "url": "string",        "artwork_url": "string"      }    ],    "albums": [      {        "album_id": "string",        "title": "string",        "artist_name": "string",        "url": "string",        "track_count": 0,        "artwork_url": "string",        "is_explicit": true      }    ],    "songs": [      {        "track_id": "string",        "title": "string",        "artist_name": "string",        "url": "string",        "duration_ms": 0,        "artwork_url": "string",        "is_explicit": true,        "preview_url": "string"      }    ],    "playlists": [      {        "playlist_id": "string",        "title": "string",        "url": "string",        "artwork_url": "string"      }    ],    "stations": [      {        "station_id": "string",        "title": "string",        "url": "string",        "artwork_url": "string"      }    ],    "music_videos": [      {        "music_video_id": "string",        "title": "string",        "artist_name": "string",        "url": "string",        "artwork_url": "string",        "is_explicit": true      }    ],    "radio_episodes": [      {        "radio_episode_id": "string",        "title": "string",        "artist_name": "string",        "url": "string",        "artwork_url": "string",        "is_explicit": true      }    ],    "total_results": 0  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}