Search
curl --request GET \
--url https://api.scraperize.com/v1/apple-music/search \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/apple-music/search"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.scraperize.com/v1/apple-music/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scraperize.com/v1/apple-music/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.scraperize.com/v1/apple-music/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.scraperize.com/v1/apple-music/search")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/apple-music/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"query": "taylor swift",
"type": "all",
"count": 137,
"topResults": [
{
"kind": "artist",
"id": "159260351",
"name": "Taylor Swift",
"headline": null,
"subtitle": "Artist",
"url": "https://music.apple.com/us/artist/taylor-swift/159260351",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a700799-2026-09-25T04-00-05.358Z_cropped.png/1640x1640bb.jpg",
"isExplicit": false
},
{
"kind": "album",
"id": "6814997249",
"name": "The Life of a Showgirl: The Encore",
"headline": null,
"subtitle": "Album · Taylor Swift",
"url": "https://music.apple.com/us/album/the-life-of-a-showgirl-the-encore/6814997249",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/3000x3000bb.jpg",
"isExplicit": true
},
{
"kind": "song",
"id": "6814997425",
"name": "Patient Zero",
"headline": null,
"subtitle": "Song · Taylor Swift",
"url": "https://music.apple.com/us/album/patient-zero/6814997249?i=6814997425",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/3000x3000bb.jpg",
"isExplicit": false
}
],
"songs": [
{
"id": "6814997425",
"name": "Patient Zero",
"url": "https://music.apple.com/us/album/patient-zero/6814997249?i=6814997425",
"albumId": "6814997249",
"albumName": null,
"releaseYear": null,
"artists": [
{
"id": "159260351",
"name": "Taylor Swift",
"url": "https://music.apple.com/us/artist/taylor-swift/159260351"
}
],
"artistName": null,
"durationMs": null,
"trackNumber": null,
"discNumber": null,
"composer": null,
"previewUrl": null,
"isExplicit": false,
"isPopular": null,
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/3000x3000bb.jpg"
},
{
"id": "1833328840",
"name": "The Fate of Ophelia",
"url": "https://music.apple.com/us/album/the-fate-of-ophelia/1833328839?i=1833328840",
"albumId": "1833328839",
"albumName": null,
"releaseYear": null,
"artists": [
{
"id": "159260351",
"name": "Taylor Swift",
"url": "https://music.apple.com/us/artist/taylor-swift/159260351"
}
],
"artistName": null,
"durationMs": null,
"trackNumber": null,
"discNumber": null,
"composer": null,
"previewUrl": null,
"isExplicit": false,
"isPopular": null,
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/2d/46/e0/2d46e0bc-8ab9-85dd-4b56-ee6951351034/25UM1IM19577.rgb.jpg/3000x3000bb.jpg"
},
{
"id": "6775527443",
"name": "I Knew It, I Knew You (From \"Toy Story 5\")",
"url": "https://music.apple.com/us/album/i-knew-it-i-knew-you-from-toy-story-5/6775527442?i=6775527443",
"albumId": "6775527442",
"albumName": null,
"releaseYear": null,
"artists": [
{
"id": "159260351",
"name": "Taylor Swift",
"url": "https://music.apple.com/us/artist/taylor-swift/159260351"
}
],
"artistName": null,
"durationMs": null,
"trackNumber": null,
"discNumber": null,
"composer": null,
"previewUrl": null,
"isExplicit": false,
"isPopular": null,
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/34/35/6c/34356cb4-bd0b-3bac-b118-1a6d7264dc64/26UMGIM69942.rgb.jpg/3000x3000bb.jpg"
}
],
"albums": [
{
"kind": "album",
"id": "6814997249",
"name": "The Life of a Showgirl: The Encore",
"headline": null,
"subtitle": "Taylor Swift",
"url": "https://music.apple.com/us/album/the-life-of-a-showgirl-the-encore/6814997249",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/3000x3000bb.jpg",
"isExplicit": true
},
{
"kind": "album",
"id": "1742057774",
"name": "THE TORTURED POETS DEPARTMENT: THE ANTHOLOGY",
"headline": null,
"subtitle": "Taylor Swift",
"url": "https://music.apple.com/us/album/the-tortured-poets-department-the-anthology/1742057774",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a4/86/59/a486593a-53c9-1c2a-5122-8f25339f7359/24UMGIM44778.rgb.jpg/3000x3000bb.jpg",
"isExplicit": true
},
{
"kind": "album",
"id": "1528112358",
"name": "folklore (deluxe version)",
"headline": null,
"subtitle": "Taylor Swift",
"url": "https://music.apple.com/us/album/folklore-deluxe-version/1528112358",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/b5/80/dc/b580dca0-349d-036b-e09b-bd849f6affd8/20UMGIM64216.rgb.jpg/3000x3000bb.jpg",
"isExplicit": true
}
],
"artists": [
{
"kind": "artist",
"id": "159260351",
"name": "Taylor Swift",
"headline": null,
"subtitle": null,
"url": "https://music.apple.com/us/artist/taylor-swift/159260351",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a700799-2026-09-25T04-00-05.358Z_cropped.png/1640x1640bb.jpg",
"isExplicit": false
},
{
"kind": "artist",
"id": "400555769",
"name": "Natalie Taylor",
"headline": null,
"subtitle": null,
"url": "https://music.apple.com/us/artist/natalie-taylor/400555769",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages211/v4/b5/3e/c7/b53ec778-048f-4f07-17aa-cd19468adf62/0aef0deb-fee7-4bfa-bab5-914d9fa38045_file_cropped.png/1122x1122bb.jpg",
"isExplicit": false
},
{
"kind": "artist",
"id": "1865952014",
"name": "Taylor Swift Tribute Songs",
"headline": null,
"subtitle": null,
"url": "https://music.apple.com/us/artist/taylor-swift-tribute-songs/1865952014",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/f3/69/70/f3697002-0508-7d32-bb03-77753e781162/artwork.jpg/3000x3000ac.jpg",
"isExplicit": false
}
],
"playlists": [
{
"kind": "playlist",
"id": "pl.3950454ced8c45a3b0cc693c2a7db97b",
"name": "Taylor Swift Essentials",
"headline": null,
"subtitle": "Apple Music Pop",
"url": "https://music.apple.com/us/playlist/taylor-swift-essentials/pl.3950454ced8c45a3b0cc693c2a7db97b",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a700799-2026-09-25T04-00-05.358Z_cropped.png/1080x1080SC.FPESS05.jpg?l=en-US",
"isExplicit": false
},
{
"kind": "playlist",
"id": "pl.57891bdd1bc840948374f1c4cbe9c840",
"name": "Taylor Swift’s Eras Tour Set List",
"headline": null,
"subtitle": "Apple Music Pop",
"url": "https://music.apple.com/us/playlist/taylor-swifts-eras-tour-set-list/pl.57891bdd1bc840948374f1c4cbe9c840",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a700799-2026-09-25T04-00-05.358Z_cropped.png/1080x1080SC.FPSL03.jpg?l=en-US",
"isExplicit": false
},
{
"kind": "playlist",
"id": "pl.455d78fed003473787886679c686fdcd",
"name": "Am I Allowed to Cry? Songs",
"headline": null,
"subtitle": "Apple Music",
"url": "https://music.apple.com/us/playlist/am-i-allowed-to-cry-songs/pl.455d78fed003473787886679c686fdcd",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Features221/v4/38/a7/da/38a7da79-1149-c368-bbe4-de472dc9b5e0/9f77923b-b8a7-4521-b821-50e58ff357b5.png/1080x1080SC.DN02.jpg?l=en-US",
"isExplicit": false
}
],
"stations": [
{
"kind": "station",
"id": "ra.a-159260351",
"name": "Taylor Swift",
"headline": null,
"subtitle": null,
"url": "https://music.apple.com/us/station/taylor-swift/ra.a-159260351",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a700799-2026-09-25T04-00-05.358Z_cropped.png/1640x1640AM.RSAB04.jpg",
"isExplicit": false
},
{
"kind": "station",
"id": "ra.1542659588",
"name": "Taylor Swift: Apple Music Awards 2020 Day 2",
"headline": null,
"subtitle": "Tune in to see Taylor Swift on the Apple Music Awards on December 15 at 5 pm PT.",
"url": "https://music.apple.com/us/station/taylor-swift-apple-music-awards-2020-day-2/ra.1542659588",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Features114/v4/4b/2f/c8/4b2fc809-3fc8-d07b-3f71-9fce6f9bdb7f/U0MtTVQtV1ctSExTLUp1c3QgZm9yIFRheWxvci5wbmc.png/4320x1080sr.jpg",
"isExplicit": false
},
{
"kind": "station",
"id": "ra.1874948486",
"name": "Taylor Swift Radio",
"headline": null,
"subtitle": null,
"url": "https://music.apple.com/us/station/taylor-swift-radio/ra.1874948486",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/1f/e4/a8/1fe4a834-8f8d-844d-ce1e-b2eb6efe0d12/WorldDetails17515411564227545544.png/600x338bb.jpg",
"isExplicit": false
}
],
"musicVideos": [
{
"kind": "music-video",
"id": "1445005781",
"name": "Shake It Off",
"headline": null,
"subtitle": "Taylor Swift",
"url": "https://music.apple.com/us/music-video/shake-it-off/1445005781",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Video2/v4/02/e7/57/02e7574c-81f8-ed99-16ef-4156276fd41c/vidtrkimg_00843930013845_1_1.jpg/1920x1080bb.jpg",
"isExplicit": false
},
{
"kind": "music-video",
"id": "1468647174",
"name": "You Need To Calm Down",
"headline": null,
"subtitle": "Taylor Swift",
"url": "https://music.apple.com/us/music-video/you-need-to-calm-down/1468647174",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Video123/v4/1b/64/29/1b64297a-b315-fbe4-61a9-a841a93548c0/19UMGIM53855.crop.jpg/1912x1072bb.jpg",
"isExplicit": false
},
{
"kind": "music-video",
"id": "6816241368",
"name": "Patient Zero",
"headline": null,
"subtitle": "Taylor Swift",
"url": "https://music.apple.com/us/music-video/patient-zero/6816241368",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Video221/v4/02/21/39/022139aa-083d-21c1-f0b9-cb7dc630dc98/26UM1IM22083.crop.jpg/3701x1912bb.jpg",
"isExplicit": false
}
],
"radioEpisodes": [
{
"kind": "radio-episode",
"id": "ra.1593740731",
"name": "Taylor Swift",
"headline": null,
"subtitle": "New Music Daily Radio",
"url": "https://music.apple.com/us/station/taylor-swift/ra.1593740731",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Features126/v4/21/bd/3a/21bd3a4a-47d1-9c24-1b3d-d01d38eaf3e8/U0MtTVMtV1ctRXAxMDAtVGF5bG9yU3dpZnQtUmFkaW8tQURBTV9JRD0xMDUzMTY1ODU3LnBuZw.png/4320x1080sr.jpg",
"isExplicit": false
},
{
"kind": "radio-episode",
"id": "ra.1649631546",
"name": "Taylor Swift",
"headline": null,
"subtitle": "New Music Daily Radio",
"url": "https://music.apple.com/us/station/taylor-swift/ra.1649631546",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Features112/v4/82/f1/22/82f12210-8a57-1a89-c407-8fb75408bc9b/453721ab-6294-4e9e-83ca-f5e4bb34fb70.png/4320x1080sr.jpg",
"isExplicit": false
},
{
"kind": "radio-episode",
"id": "ra.1738080111",
"name": "Taylor Swift",
"headline": null,
"subtitle": "New Music Daily Radio",
"url": "https://music.apple.com/us/station/taylor-swift/ra.1738080111",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Features/v4/68/4c/ac/684cac44-ae08-3d11-a73d-135ab063e5fa/cc75276d-6e0c-4d53-a138-6f8298d51931.png/4320x1080sr.jpg",
"isExplicit": false
}
],
"fetchedAt": "2026-11-10T16:02:31.760Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key required — pass it in the `x-api-key` header.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "This request costs 1 credit, but your balance is 0. Top up to continue.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"details": [
{
"path": "url",
"message": "url is required"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded — max 100 requests per 60s. Retry in ~30s.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UPSTREAM_BLOCKED",
"message": "The source is temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}Apple Music
Search
Searches Apple Music (US storefront) by keyword, up to ~21 results per type as the web player shows them: top results, songs (with artists and album), albums, artists, playlists, stations, music videos and radio episodes — each with its id, name, subtitle, link, artwork and explicit flag. type returns one kind only (the other lists are empty). Only publicly available data is returned.
GET
/
v1
/
apple-music
/
search
Search
curl --request GET \
--url https://api.scraperize.com/v1/apple-music/search \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/apple-music/search"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.scraperize.com/v1/apple-music/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scraperize.com/v1/apple-music/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.scraperize.com/v1/apple-music/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.scraperize.com/v1/apple-music/search")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/apple-music/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"query": "taylor swift",
"type": "all",
"count": 137,
"topResults": [
{
"kind": "artist",
"id": "159260351",
"name": "Taylor Swift",
"headline": null,
"subtitle": "Artist",
"url": "https://music.apple.com/us/artist/taylor-swift/159260351",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a700799-2026-09-25T04-00-05.358Z_cropped.png/1640x1640bb.jpg",
"isExplicit": false
},
{
"kind": "album",
"id": "6814997249",
"name": "The Life of a Showgirl: The Encore",
"headline": null,
"subtitle": "Album · Taylor Swift",
"url": "https://music.apple.com/us/album/the-life-of-a-showgirl-the-encore/6814997249",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/3000x3000bb.jpg",
"isExplicit": true
},
{
"kind": "song",
"id": "6814997425",
"name": "Patient Zero",
"headline": null,
"subtitle": "Song · Taylor Swift",
"url": "https://music.apple.com/us/album/patient-zero/6814997249?i=6814997425",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/3000x3000bb.jpg",
"isExplicit": false
}
],
"songs": [
{
"id": "6814997425",
"name": "Patient Zero",
"url": "https://music.apple.com/us/album/patient-zero/6814997249?i=6814997425",
"albumId": "6814997249",
"albumName": null,
"releaseYear": null,
"artists": [
{
"id": "159260351",
"name": "Taylor Swift",
"url": "https://music.apple.com/us/artist/taylor-swift/159260351"
}
],
"artistName": null,
"durationMs": null,
"trackNumber": null,
"discNumber": null,
"composer": null,
"previewUrl": null,
"isExplicit": false,
"isPopular": null,
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/3000x3000bb.jpg"
},
{
"id": "1833328840",
"name": "The Fate of Ophelia",
"url": "https://music.apple.com/us/album/the-fate-of-ophelia/1833328839?i=1833328840",
"albumId": "1833328839",
"albumName": null,
"releaseYear": null,
"artists": [
{
"id": "159260351",
"name": "Taylor Swift",
"url": "https://music.apple.com/us/artist/taylor-swift/159260351"
}
],
"artistName": null,
"durationMs": null,
"trackNumber": null,
"discNumber": null,
"composer": null,
"previewUrl": null,
"isExplicit": false,
"isPopular": null,
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/2d/46/e0/2d46e0bc-8ab9-85dd-4b56-ee6951351034/25UM1IM19577.rgb.jpg/3000x3000bb.jpg"
},
{
"id": "6775527443",
"name": "I Knew It, I Knew You (From \"Toy Story 5\")",
"url": "https://music.apple.com/us/album/i-knew-it-i-knew-you-from-toy-story-5/6775527442?i=6775527443",
"albumId": "6775527442",
"albumName": null,
"releaseYear": null,
"artists": [
{
"id": "159260351",
"name": "Taylor Swift",
"url": "https://music.apple.com/us/artist/taylor-swift/159260351"
}
],
"artistName": null,
"durationMs": null,
"trackNumber": null,
"discNumber": null,
"composer": null,
"previewUrl": null,
"isExplicit": false,
"isPopular": null,
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/34/35/6c/34356cb4-bd0b-3bac-b118-1a6d7264dc64/26UMGIM69942.rgb.jpg/3000x3000bb.jpg"
}
],
"albums": [
{
"kind": "album",
"id": "6814997249",
"name": "The Life of a Showgirl: The Encore",
"headline": null,
"subtitle": "Taylor Swift",
"url": "https://music.apple.com/us/album/the-life-of-a-showgirl-the-encore/6814997249",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/3000x3000bb.jpg",
"isExplicit": true
},
{
"kind": "album",
"id": "1742057774",
"name": "THE TORTURED POETS DEPARTMENT: THE ANTHOLOGY",
"headline": null,
"subtitle": "Taylor Swift",
"url": "https://music.apple.com/us/album/the-tortured-poets-department-the-anthology/1742057774",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a4/86/59/a486593a-53c9-1c2a-5122-8f25339f7359/24UMGIM44778.rgb.jpg/3000x3000bb.jpg",
"isExplicit": true
},
{
"kind": "album",
"id": "1528112358",
"name": "folklore (deluxe version)",
"headline": null,
"subtitle": "Taylor Swift",
"url": "https://music.apple.com/us/album/folklore-deluxe-version/1528112358",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/b5/80/dc/b580dca0-349d-036b-e09b-bd849f6affd8/20UMGIM64216.rgb.jpg/3000x3000bb.jpg",
"isExplicit": true
}
],
"artists": [
{
"kind": "artist",
"id": "159260351",
"name": "Taylor Swift",
"headline": null,
"subtitle": null,
"url": "https://music.apple.com/us/artist/taylor-swift/159260351",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a700799-2026-09-25T04-00-05.358Z_cropped.png/1640x1640bb.jpg",
"isExplicit": false
},
{
"kind": "artist",
"id": "400555769",
"name": "Natalie Taylor",
"headline": null,
"subtitle": null,
"url": "https://music.apple.com/us/artist/natalie-taylor/400555769",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages211/v4/b5/3e/c7/b53ec778-048f-4f07-17aa-cd19468adf62/0aef0deb-fee7-4bfa-bab5-914d9fa38045_file_cropped.png/1122x1122bb.jpg",
"isExplicit": false
},
{
"kind": "artist",
"id": "1865952014",
"name": "Taylor Swift Tribute Songs",
"headline": null,
"subtitle": null,
"url": "https://music.apple.com/us/artist/taylor-swift-tribute-songs/1865952014",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/f3/69/70/f3697002-0508-7d32-bb03-77753e781162/artwork.jpg/3000x3000ac.jpg",
"isExplicit": false
}
],
"playlists": [
{
"kind": "playlist",
"id": "pl.3950454ced8c45a3b0cc693c2a7db97b",
"name": "Taylor Swift Essentials",
"headline": null,
"subtitle": "Apple Music Pop",
"url": "https://music.apple.com/us/playlist/taylor-swift-essentials/pl.3950454ced8c45a3b0cc693c2a7db97b",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a700799-2026-09-25T04-00-05.358Z_cropped.png/1080x1080SC.FPESS05.jpg?l=en-US",
"isExplicit": false
},
{
"kind": "playlist",
"id": "pl.57891bdd1bc840948374f1c4cbe9c840",
"name": "Taylor Swift’s Eras Tour Set List",
"headline": null,
"subtitle": "Apple Music Pop",
"url": "https://music.apple.com/us/playlist/taylor-swifts-eras-tour-set-list/pl.57891bdd1bc840948374f1c4cbe9c840",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a700799-2026-09-25T04-00-05.358Z_cropped.png/1080x1080SC.FPSL03.jpg?l=en-US",
"isExplicit": false
},
{
"kind": "playlist",
"id": "pl.455d78fed003473787886679c686fdcd",
"name": "Am I Allowed to Cry? Songs",
"headline": null,
"subtitle": "Apple Music",
"url": "https://music.apple.com/us/playlist/am-i-allowed-to-cry-songs/pl.455d78fed003473787886679c686fdcd",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Features221/v4/38/a7/da/38a7da79-1149-c368-bbe4-de472dc9b5e0/9f77923b-b8a7-4521-b821-50e58ff357b5.png/1080x1080SC.DN02.jpg?l=en-US",
"isExplicit": false
}
],
"stations": [
{
"kind": "station",
"id": "ra.a-159260351",
"name": "Taylor Swift",
"headline": null,
"subtitle": null,
"url": "https://music.apple.com/us/station/taylor-swift/ra.a-159260351",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a700799-2026-09-25T04-00-05.358Z_cropped.png/1640x1640AM.RSAB04.jpg",
"isExplicit": false
},
{
"kind": "station",
"id": "ra.1542659588",
"name": "Taylor Swift: Apple Music Awards 2020 Day 2",
"headline": null,
"subtitle": "Tune in to see Taylor Swift on the Apple Music Awards on December 15 at 5 pm PT.",
"url": "https://music.apple.com/us/station/taylor-swift-apple-music-awards-2020-day-2/ra.1542659588",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Features114/v4/4b/2f/c8/4b2fc809-3fc8-d07b-3f71-9fce6f9bdb7f/U0MtTVQtV1ctSExTLUp1c3QgZm9yIFRheWxvci5wbmc.png/4320x1080sr.jpg",
"isExplicit": false
},
{
"kind": "station",
"id": "ra.1874948486",
"name": "Taylor Swift Radio",
"headline": null,
"subtitle": null,
"url": "https://music.apple.com/us/station/taylor-swift-radio/ra.1874948486",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/1f/e4/a8/1fe4a834-8f8d-844d-ce1e-b2eb6efe0d12/WorldDetails17515411564227545544.png/600x338bb.jpg",
"isExplicit": false
}
],
"musicVideos": [
{
"kind": "music-video",
"id": "1445005781",
"name": "Shake It Off",
"headline": null,
"subtitle": "Taylor Swift",
"url": "https://music.apple.com/us/music-video/shake-it-off/1445005781",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Video2/v4/02/e7/57/02e7574c-81f8-ed99-16ef-4156276fd41c/vidtrkimg_00843930013845_1_1.jpg/1920x1080bb.jpg",
"isExplicit": false
},
{
"kind": "music-video",
"id": "1468647174",
"name": "You Need To Calm Down",
"headline": null,
"subtitle": "Taylor Swift",
"url": "https://music.apple.com/us/music-video/you-need-to-calm-down/1468647174",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Video123/v4/1b/64/29/1b64297a-b315-fbe4-61a9-a841a93548c0/19UMGIM53855.crop.jpg/1912x1072bb.jpg",
"isExplicit": false
},
{
"kind": "music-video",
"id": "6816241368",
"name": "Patient Zero",
"headline": null,
"subtitle": "Taylor Swift",
"url": "https://music.apple.com/us/music-video/patient-zero/6816241368",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Video221/v4/02/21/39/022139aa-083d-21c1-f0b9-cb7dc630dc98/26UM1IM22083.crop.jpg/3701x1912bb.jpg",
"isExplicit": false
}
],
"radioEpisodes": [
{
"kind": "radio-episode",
"id": "ra.1593740731",
"name": "Taylor Swift",
"headline": null,
"subtitle": "New Music Daily Radio",
"url": "https://music.apple.com/us/station/taylor-swift/ra.1593740731",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Features126/v4/21/bd/3a/21bd3a4a-47d1-9c24-1b3d-d01d38eaf3e8/U0MtTVMtV1ctRXAxMDAtVGF5bG9yU3dpZnQtUmFkaW8tQURBTV9JRD0xMDUzMTY1ODU3LnBuZw.png/4320x1080sr.jpg",
"isExplicit": false
},
{
"kind": "radio-episode",
"id": "ra.1649631546",
"name": "Taylor Swift",
"headline": null,
"subtitle": "New Music Daily Radio",
"url": "https://music.apple.com/us/station/taylor-swift/ra.1649631546",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Features112/v4/82/f1/22/82f12210-8a57-1a89-c407-8fb75408bc9b/453721ab-6294-4e9e-83ca-f5e4bb34fb70.png/4320x1080sr.jpg",
"isExplicit": false
},
{
"kind": "radio-episode",
"id": "ra.1738080111",
"name": "Taylor Swift",
"headline": null,
"subtitle": "New Music Daily Radio",
"url": "https://music.apple.com/us/station/taylor-swift/ra.1738080111",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Features/v4/68/4c/ac/684cac44-ae08-3d11-a73d-135ab063e5fa/cc75276d-6e0c-4d53-a138-6f8298d51931.png/4320x1080sr.jpg",
"isExplicit": false
}
],
"fetchedAt": "2026-11-10T16:02:31.760Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key required — pass it in the `x-api-key` header.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "This request costs 1 credit, but your balance is 0. Top up to continue.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"details": [
{
"path": "url",
"message": "url is required"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded — max 100 requests per 60s. Retry in ~30s.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UPSTREAM_BLOCKED",
"message": "The source is temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}Cost: 1 credit per successful request. Errors and cache hits (
cache_max_age) are free.Copy for AI assistant
Copy for AI assistant
Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button).
Prompt
I want to make an API call to /v1/apple-music/search. Here are the details:
Endpoint: GET https://api.scraperize.com/v1/apple-music/search
Description: Searches Apple Music (US storefront) by keyword, up to ~21 results per type as the web player shows them: top results, songs (with artists and album), albums, artists, playlists, stations, music videos and radio episodes — each with its id, name, subtitle, link, artwork and explicit flag. `type` returns one kind only (the other lists are empty). Only publicly available data is returned.
Required Headers:
- x-api-key: Your API key
Parameters:
- query (string) [required]: What to search for.
- type (select): What to return: `all` (default) or one kind.
- cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh.
Example Response:
{
"data": {
"query": "taylor swift",
"type": "all",
"count": 137,
"topResults": [
{
"kind": "artist",
"id": "159260351",
"name": "Taylor Swift",
"headline": null,
"subtitle": "Artist",
"url": "https://music.apple.com/us/artist/taylor-swift/159260351",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a70…",
"isExplicit": false
}
],
"songs": [
{
"id": "6814997425",
"name": "Patient Zero",
"url": "https://music.apple.com/us/album/patient-zero/6814997249?i=6814997425",
"albumId": "6814997249",
"albumName": null,
"releaseYear": null,
"artists": [
{
"id": "159260351",
"name": "Taylor Swift",
"url": "https://music.apple.com/us/artist/taylor-swift/159260351"
}
],
"artistName": null,
"durationMs": null,
"trackNumber": null,
"discNumber": null,
"composer": null,
"previewUrl": null,
"isExplicit": false,
"isPopular": null,
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/3000x3000bb.jpg"
}
],
"albums": [
{
"kind": "album",
"id": "6814997249",
"name": "The Life of a Showgirl: The Encore",
"headline": null,
"subtitle": "Taylor Swift",
"url": "https://music.apple.com/us/album/the-life-of-a-showgirl-the-encore/6814997249",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/3000x3000bb.jpg",
"isExplicit": true
}
],
"artists": [
{
"kind": "artist",
"id": "159260351",
"name": "Taylor Swift",
"headline": null,
"subtitle": null,
"url": "https://music.apple.com/us/artist/taylor-swift/159260351",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a70…",
"isExplicit": false
}
],
"playlists": [
{
"kind": "playlist",
"id": "pl.3950454ced8c45a3b0cc693c2a7db97b",
"name": "Taylor Swift Essentials",
"headline": null,
"subtitle": "Apple Music Pop",
"url": "https://music.apple.com/us/playlist/taylor-swift-essentials/pl.3950454ced8c45a3b0cc693c2a7db97b",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a70…",
"isExplicit": false
}
],
"stations": [
{
"kind": "station",
"id": "ra.a-159260351",
"name": "Taylor Swift",
"headline": null,
"subtitle": null,
"url": "https://music.apple.com/us/station/taylor-swift/ra.a-159260351",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a70…",
"isExplicit": false
}
],
"musicVideos": [
{
"kind": "music-video",
"id": "1445005781",
"name": "Shake It Off",
"headline": null,
"subtitle": "Taylor Swift",
"url": "https://music.apple.com/us/music-video/shake-it-off/1445005781",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Video2/v4/02/e7/57/02e7574c-81f8-ed99-16ef-4156276fd41c/vidtrkimg_00843930013845_1_1.jpg/1920x1080bb.jpg",
"isExplicit": false
}
],
"radioEpisodes": [
{
"kind": "radio-episode",
"id": "ra.1593740731",
"name": "Taylor Swift",
"headline": null,
"subtitle": "New Music Daily Radio",
"url": "https://music.apple.com/us/station/taylor-swift/ra.1593740731",
"artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Features126/v4/21/bd/3a/21bd3a4a-47d1-9c24-1b3d-d01d38eaf3e8/U0MtTVMtV1ctRXAxMDAtVGF5bG9yU3dpZnQtUmFkaW8tQURBTV9JRD0xMD…",
"isExplicit": false
}
],
"fetchedAt": "2026-11-10T16:02:31.760Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}
Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices.
Authorizations
Your API key. Send it in the x-api-key header (or Authorization: Bearer <key>). Create and manage keys from your dashboard.
Query Parameters
What to search for.
What to return: all (default) or one kind.
Available options:
all, song, album, artist, playlist, station, music-video, radio-episode Optional. Return a cached result if one this age or newer exists — served for 0 credits with meta.cached=true and meta.cachedAt. Otherwise a fresh scrape runs (1 credit) and refreshes the cache. Omit to always scrape fresh.
Available options:
1d, 3d, 7d, 14d, 30d