Search
GET
/v1/music:itunes/searchpassing · 0.1s5m cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| query | string | query | Search term (title, artist, album). Required. |
| entity | enum | query | Entity type: song|album|musicArtist. Default song. One of song, album, musicArtist. |
| limit | number | query | 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
Try it
Live request with your key
const data = await client.run( "music:itunes", "search", { query: "blinding lights", entity: "song", limit: 25 });
iTunes
Search music tracks and albums.
1 endpoint3 calls1/1 passing
GET
/v1/…itunes/searchpassing · 0.1s5m cache
Try it
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 });