- Docs
- Apple Music
- Apple Music track API
Apple Music track API
Title, artists, album, duration, ISRC, composer and the 30 second preview.
GET /v1/apple-music/track
GET /v1/apple-music/track
Title, artists, album, duration, ISRC, composer and the 30 second preview. A track link on an album page ends in ?i=<song id>; that id is the song's.
- Cost: 1 credit
- Cache: Results are kept up to 30 days; send
max_age_daysto reuse them for free. - Timeout: A request still running after about 25 seconds answers
202with a job to poll (Batch and jobs).
Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
url | URL | one of | Apple Music song URL. Accepted hosts: music.apple.com. |
id | string | one of | Apple Music song id. |
Send at least one of url, id. If you send several, the first listed is used and the rest are ignored.
Every request also accepts:
region: two-letter country code for results that vary by country. Changing it restarts the cursor chain.trim:truefor a smaller response withoutnullfields andextra.raw:trueto also get the platform's original object asraw.max_age_days: accept a cached result up to this many days old, for 0 credits (Caching).
Example request#
Set your key in the environment first (see Authentication).
1curl -G "https://api.socialscrape.dev/v1/apple-music/track" \2 -H "x-api-key: $SOCIALSCRAPE_API_KEY" \3 --data-urlencode "id=1468058169"1import os2import requests34params = {5 "id": "1468058169",6}7res = requests.get(8 "https://api.socialscrape.dev/v1/apple-music/track",9 headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},10 params=params,11)12body = res.json()1314if body["ok"]:15 print(body["data"])16else:17 print(body["error"]["code"], body["error"]["message"])1const url = new URL("https://api.socialscrape.dev/v1/apple-music/track");2url.search = new URLSearchParams({3 "id": "1468058169"4}).toString();5const res = await fetch(url, {6 headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },7});8const body = await res.json();910if (body.ok) {11 console.log(body.data);12} else {13 console.error(body.error.code, body.error.message);14}1{2 "nodes": [3 {4 "name": "SocialScrape Apple Music track",5 "type": "n8n-nodes-base.httpRequest",6 "typeVersion": 4.2,7 "position": [8 0,9 010 ],11 "parameters": {12 "method": "GET",13 "url": "https://api.socialscrape.dev/v1/apple-music/track",14 "sendQuery": true,15 "queryParameters": {16 "parameters": [17 {18 "name": "id",19 "value": "1468058169"20 }21 ]22 },23 "sendHeaders": true,24 "headerParameters": {25 "parameters": [26 {27 "name": "x-api-key",28 "value": "={{ $env.SOCIALSCRAPE_API_KEY }}"29 }30 ]31 }32 }33 }34 ],35 "connections": {}36}Example response#
This is a sample from a recorded response, lists and long text are shortened. Status 200.
200 OKSample response
1{2 "ok": true,3 "credits_charged": 1,4 "credits_remaining": 4999,5 "cached": false,6 "cached_at": null,7 "request_id": "req_d8c814d2f32115bfd96e3add",8 "data": {9 "object": "song",10 "platform": "apple_music",11 "id": "1468058169",12 "url": "https://music.apple.com/us/album/i-forgot-that-you-existed/1468058165?i=1468058169",13 "title": "I Forgot That You Existed",14 "artists": [15 "Taylor Swift"16 ],17 "album": "Lover",18 "duration_seconds": 170.651,19 "cover_url": "https://is1-ssl.mzstatic.com/image/thumb/Music125/v4/49/3d/ab/493dab54-f920-9043-6181-80993b8116c9/19UMGIM53909.rgb.jpg/1200x1200bb.jpg",20 "preview_url": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/9c/e2/97/9ce2976a-b1c8-aa80-3e94-f4562cbad53e/mzaf_13898706762824220632.plus.aac.ep.m4a",21 "released_at": "2019-08-23",22 "isrc": "USUG11901471",23 "explicit": false,24 "is_original": null,25 "stats": {26 "plays": null,27 "uses": null,28 "likes": null29 },30 "extra": {31 "album_artist": "Taylor Swift",32 "album_id": "1468058165",33 "album_url": "https://music.apple.com/us/album/lover/1468058165",34 "artist_ids": [35 "159260351"36 ],37 "audio_locale": "en-US",38 "audio_traits": [39 "atmos",40 "lossless",41 "lossy-stereo"42 ],43 "composer": "Taylor Swift, Louis Bell & Adam Feeney",44 "disc_number": 1,45 "genres": [46 "Pop",47 "Music"48 ],49 "has_lyrics": true,50 "has_time_synced_lyrics": true,51 "is_apple_digital_master": true,52 "track_number": 153 }54 },55 "cursor": null,56 "has_more": null57}Response#
A Song object in data.
See Data models for every field. The envelope around data is described in Responses.
Errors#
Failures are free: credits_charged is 0. Branch on error.code, never on the message.
| Code | HTTP | Retry | Meaning |
|---|---|---|---|
invalid_params | 400 | no | A parameter is missing, unknown or has the wrong type. |
unsupported_url | 400 | no | The URL is not one this endpoint accepts (wrong platform or form). |
not_found | 404 | no | The platform says this profile, post or item does not exist. |
Every request can also fail with the account and platform errors listed on the Errors page.
Example error:
1{2 "ok": false,3 "error": {4 "code": "unsupported_url",5 "message": "The URL is not one this endpoint accepts (wrong platform or form).",6 "retryable": false7 },8 "credits_charged": 0,9 "request_id": "req_95a1deadd6bea5c1b8414bd5"10}Related endpoints#
- Apple Music artist (
GET /v1/apple-music/artist) - Apple Music album (
GET /v1/apple-music/album) - Apple Music search (
GET /v1/apple-music/search)