Apple Music's US top ten
GET /api/v1/chart
GET https://terminal.cloud.wavo.me/api/v1/chartThe top ten songs of Apple Music's US chart today, each with its artist and its move since the day before; limit keeps the first few. The whole chart, and Canada's, are a subscriber's.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
limit | query | integer, 1–10 | No | Only the first this many songs; every one when left out. |
Request
curl 'https://terminal.cloud.wavo.me/api/v1/chart?limit=3'Response
200, application/json: the Chart schema in /openapi.json.
| Field | Type | Description |
|---|---|---|
readAt | string | An instant, ISO 8601 in UTC. |
chart | object or null | The top ten of Apple Music's US chart; null before its first read. |
chart.source | Apple Music | |
chart.territory | string | ISO 3166 code: US. |
chart.name | string | The territory's name. |
chart.day | string | The chart's day, YYYY-MM-DD. |
chart.fetchedAt | string | An instant, ISO 8601 in UTC. |
chart.songs | array of objects | |
chart.songs[].rank | integer | |
chart.songs[].title | string | |
chart.songs[].artist | string | |
chart.songs[].move | one of new, same, up, down | Its move since the day before: new to the chart, or same place. |
chart.songs[].by | integer or null | The places it moved up or down. |
chart.songs[].url | string or null | The song on Apple Music. |
Statuses
Every answer carries RateLimit-Policy; a refusal is an RFC 9457 problem, whose codes Errors lists.
| Status | When |
|---|---|
200 | Apple Music's US top ten. |
400 | A parameter its schema refuses: invalid_parameter, naming it. |
405 | Any method but GET: method_not_allowed. The API only reads. |
429 | The IP address spent its bucket: rate_limit_exceeded. |
503 | The read behind the answer failed: read_failed. Retry shortly. |