Apple Music Charts API
API 한 번의 호출로 Apple Music Charts 데이터를 받아 가세요. Returns what a country is playing most on Apple Music right now: the Top Songs, Top Albums, Top Music Videos or Top Playlists chart, with no keyword in. Each item is a Post: `content.text` is the title, `author.username` the artist, `url` the Apple Music link and `content.thumbnail_url` the artwork. The chart position is on `ext.trend`: `rank` (1 is the top), `country_code`, `chart` and Apple's own `chart_title` and `updated_at`. `ext.apple_music` carries `kind`, `release_date`, `artist_id`, `artist_url`, `genres` and `content_advisory`. `published_at` is the release date at midnight UTC. Playlists have no artist or release date, so those are null. The item ids work with /v1/apple_music/track and /v1/apple_music/album for the full record. A country Apple Music does not publish a chart for is a free 400. Exact repeats within an hour are served from cache at 0 credits.
2026년 9월 업데이트SocialCrawl 팀이 직접 관리해요
국가별 Apple Music 차트를 1위부터 순서대로 돌려줍니다. 곡, 앨범, 뮤직비디오, 플레이리스트 차트 중 하나를 고를 수 있고 아티스트, 커버 아트, 발매일, 장르가 함께 나옵니다.
곡 이름 없이 한 시장에서 지금 많이 듣는 음악을 볼 때 사용하세요. 국가별 차트 순위를 꾸준히 추적할 때도 좋습니다.
67개 플랫폼을 병렬로 검색합니다
Charts API로 무엇을 할 수 있을까요
Charts 엔드포인트가 통합 스키마와 계산 필드를 담은 Apple Music 데이터를 한 번의 요청으로 보내드려요. 스크래핑 인프라를 직접 만들거나 유지할 필요가 없어요.
요청 예시
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/apple_music/charts?country=de&type=songs&limit=10"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/apple_music/charts",
params={
'country': 'de',
'type': 'songs',
'limit': '10',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/apple_music/charts?country=de&type=songs&limit=10",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
| country | 아니오 | Country as an ISO 3166-1 alpha-2 code, in any case (`us`, `DE`, `kr`). Apple Music publishes a chart for most countries where it is sold; one it does not is rejected with a free 400. `uk` is read as `gb`. Defaults to `us`. |
| type | 아니오 | Which chart: `songs` (the default), `albums`, `music-videos` or `playlists`. (songs | albums | music-videos | playlists) |
| limit | 아니오 | How many chart positions to return, from the top, 1 to 100. Defaults to 50. |
Apple Music Charts API는 무엇을 돌려주나요
이 엔드포인트의 응답 구조와 필드를 보여 주는 예시예요. 값은 이해를 돕기 위한 것이며 실제 조회 결과는 아니에요.
응답 예시 보기
{
"success": true,
"platform": "apple_music",
"endpoint": "/v1/apple_music/charts",
"data": {
"items": [
{
"post": {
"id": "6769070199",
"url": "https://music.apple.com/de/album/movin-to-the-sun/6769069923?i=6769070199",
"content": {
"text": "Movin' To The Sun",
"media_urls": null,
"thumbnail_url": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/96/61/7a/96617ab5-51da-7cfc-97e5-c5a6a893c210/1087654.jpg/100x100bb.jpg",
"duration_seconds": null
},
"author": {
"username": "HUGEL, Imael Angel & Ultra Naté",
"display_name": "HUGEL, Imael Angel & Ultra Naté",
"avatar_url": null,
"verified": null
},
"engagement": {
"views": null,
"likes": null,
"comments": null,
"shares": null,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": null,
"deleted": false
},
"published_at": "2026-05-22T00:00:00.000Z",
"ext": {
"apple_music": {
"kind": "songs",
"release_date": "2026-05-22",
"artist_id": "978839124",
"artist_url": "https://music.apple.com/de/artist/hugel/978839124",
"genres": [
{
"id": "7",
"name": "Electronic"
},
{
"id": "34",
"name": "Musik"
},
{
"id": "17",
"name": "Dance"
}
],
"content_advisory": null
},
"trend": {
"rank": 1,
"country_code": "DE",
"chart": "songs",
"chart_title": "Top-Titel",
"updated_at": "2026-09-23T01:27:30.000Z"
}
}
},
"computed": {
"engagement_rate": null,
"language": null,
"content_category": "other",
"estimated_reach": null
}
}
],
"total": 10,
"dropped": 0
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req-a1b2c3d4e5f6",
"pagination": {
"next_cursor": null,
"has_more": false,
"page_size": 10
}
}문서에 나온 응답 구조를 보여 주는 예시예요. 값은 이해를 돕기 위한 것이며 운영 환경에서 가져온 응답이 아니에요.
Apple Music Charts API는 어떻게 동작하나요
API 키와 함께 GET 요청을 보내면, 통합 스키마와 계산 필드를 담은 깔끔한 JSON이 돌아와요.
메서드
GET
응답 형식
JSON
소셜 미디어 데이터를 몇 초 만에 수집하는 방법
개발자를 위한 가장 빠른 소셜 미디어 스크래핑 API. 월간 활성 사용자 100억 명 이상을 포괄하는 67개 플랫폼에서 프로필, 게시물, 댓글, 분석 데이터를 수집하세요.
모든 플랫폼을 하나의 스키마로
동일한 응답 구조로 67개 플랫폼을 조회하세요. 연동은 한 번이면 충분합니다.
단순 수집을 넘어 계산된 필드 제공
엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때, 정규화된 레코드에 engagement_rate, estimated_reach, content_category, language를 함께 담아 바로 활용할 수 있습니다.
코드 한 줄 쓰기 전에, 데이터부터
Visual Data Explorer에 URL만 붙여넣으면 결과 카드와 정형화된 테이블, CSV 내보내기를 바로 사용할 수 있습니다.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Apple Music Charts 데이터, 가져올 준비 되셨어요?
API 키 받고 60초 안에 Apple Music 데이터를 받아 가세요.
