iTunes

Search music tracks and albums.

1 endpoint3 calls1/1 passing
Get API key
GET/v1/…itunes/search
passing · 0.1s5m cache

Try it

Checking your keys…

Parameters

query

string · query · required

Search term (title, artist, album).

entity

enum · query · optional

Entity type: song|album|musicArtist. Default song.

limit

number · query · optional

Items count (1-200). Default 25.

Example response

{"project":"music:itunes",  "data": {"ok":true,"count":25,    "results": [      {"kind":"song","country":"USA","trackId":1488408568,"artistId":479756766,"trackName":"Blinding Lights","artistName":"The Weeknd","previewUrl":"https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview211/v4/17/b4/8f/17b48f9a-0b93-6bb8-fe1d-3a16623c2cfb/mzaf_9560252727299052414.plus.aac.p.m4a","releaseDate":"2019-11-29T12:00:00Z","collectionId":1488408555,"trackViewUrl":"https://music.apple.com/us/album/blinding-lights/1488408555?i=1488408568&uo=4","artistViewUrl":"https://music.apple.com/us/artist/the-weeknd/479756766?uo=4","artworkUrl100":"https://is1-ssl.mzstatic.com/image/thumb/Music125/v4/a6/6e/bf/a66ebf79-5008-8948-b352-a790fc87446b/19UM1IM04638.rgb.jpg/100x100bb.jpg","collectionName":"Blinding Lights - Single","trackTimeMillis":201570,"primaryGenreName":"R&B/Soul","collectionViewUrl":"https://music.apple.com/us/album/blinding-lights/1488408555?i=1488408568&uo=4"      },      {"kind":"song","country":"USA","trackId":1513133940,"artistId":1462541757,"trackName":"Blinding Lights","artistName":"Teddy Swims","previewUrl":"https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview125/v4/4f/3a/c6/4f3ac6e5-50a3-2045-cd71-e51d103c1ad6/mzaf_1456231008946328070.plus.aac.p.m4a","releaseDate":"2020-05-15T12:00:00Z","collectionId":1513133938,"trackViewUrl":"https://music.apple.com/us/album/blinding-lights/1513133938?i=1513133940&uo=4","artistViewUrl":"https://music.apple.com/us/artist/teddy-swims/1462541757?uo=4","artworkUrl100":"https://is1-ssl.mzstatic.com/image/thumb/Music113/v4/8a/e6/47/8ae64750-3dcf-ac4d-b0f6-c70c92893494/054391934000.jpg/100x100bb.jpg","collectionName":"Blinding Lights - Single","trackTimeMillis":214875,"primaryGenreName":"Pop","collectionViewUrl":"https://music.apple.com/us/album/blinding-lights/1513133938?i=1513133940&uo=4"      },      {"kind":"song","country":"USA","trackId":1542842761,"artistId":479756766,"trackName":"Blinding Lights (Remix)","artistName":"The Weeknd & ROSALÍA","previewUrl":"https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/08/fe/de/08fede6c-762e-b24f-f4ff-a9e51bbde1cc/mzaf_6048815850106316934.plus.aac.p.m4a","releaseDate":"2020-12-04T12:00:00Z","collectionId":1542842760,"trackViewUrl":"https://music.apple.com/us/album/blinding-lights-remix/1542842760?i=1542842761&uo=4","artistViewUrl":"https://music.apple.com/us/artist/the-weeknd/479756766?uo=4","artworkUrl100":"https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/61/e7/3f/61e73f94-018d-5f50-50ec-8521952bc72e/20UM1IM11629.rgb.jpg/100x100bb.jpg","collectionName":"Blinding Lights (Remix) - Single","trackTimeMillis":216123,"primaryGenreName":"R&B/Soul","collectionViewUrl":"https://music.apple.com/us/album/blinding-lights-remix/1542842760?i=1542842761&uo=4"      }    ]  },"timestamp":"2026-05-27T13:27:15Z"}

Errors

  • 401Missing or invalid x-api-key
  • 404Not found or private
  • 429Rate limit or monthly quota reached

Code

const data = await client.run(  "music:itunes",  "search",  { query: "blinding lights", entity: "song", limit: 25 });