# Apple API: List top charts > Lists the current top songs, albums, or music videos on Apple Music for a country, in chart order. Countries without an Apple Music chart return no results. Unofficial. Not affiliated with or endorsed by Apple. - Page: https://fous.com/methods/music.apple.com/list-top-charts - Method: `music.apple.com/list_top_charts`, version 1 - Website: music.apple.com - Returns: rank, title, artist, genre, release date, cover image, Apple Music URL, Apple ID - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `chart` | string | no | `"top_songs"` | Chart to list, for example top_albums. One of "top_songs", "top_albums", "top_music_videos". Default "top_songs". | | `country` | string | no | `"United States"` | Country name or two-letter code, for example Canada or CA. Default "United States". | | `max_results` | integer | no | | Number of entries, for example 25 (maximum 100). Default 50. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "chart": "top_songs", "country": "United States" } ``` Its output: ```json { "items": [ { "rank": 1, "genre": "Pop", "title": "Housewife", "artist": "Tate McRae", "apple_id": "6822497774", "release_date": "2026-10-15", "apple_music_url": "https://music.apple.com/us/album/housewife/6822497770?i=6822497774", "cover_image_url": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/2b/96/2b/2b962b77-3a04-5650-aefd-37ecfce04b03/196874840146.jpg/100x100bb.jpg" }, { "rank": 2, "genre": "Country", "title": "Lies (feat. Lana Del Rey)", "artist": "Zach Bryan & Lana Del Rey", "apple_id": "6822944296", "release_date": "2026-10-15", "apple_music_url": "https://music.apple.com/us/album/lies-feat-lana-del-rey/6822944288?i=6822944296", "cover_image_url": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/ea/98/f2/ea98f2b8-5131-29ae-2064-997234ef13bc/093624812647.jpg/100x100bb.jpg" }, { "rank": 3, "genre": "Country", "title": "Choosin' Texas", "artist": "Ella Langley", "apple_id": "1844932150", "release_date": "2025-10-17", "apple_music_url": "https://music.apple.com/us/album/choosin-texas/1844932149?i=1844932150", "cover_image_url": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/e2/91/4d/e2914d0a-7f1d-f04c-fbf4-c50b38548838/196873638690.jpg/100x100bb.jpg" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"music.apple.com/list_top_charts","input":{"chart":"top_songs","country":"United States"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What are the top 25 albums on Apple Music in Canada right now? - Show me the current top songs chart for the United States, top 50 entries. - Which music videos are trending on Apple Music in Japan this week? Give me the top 10 with artists. - I need the top albums ranking in Germany on Apple Music, including release dates and genres. - Pull up apple.com's top songs list for the UK, limited to 20 results in chart order. ## Input schema ```json { "type": "object", "required": [], "properties": { "chart": { "enum": [ "top_songs", "top_albums", "top_music_videos" ], "type": "string", "default": "top_songs", "description": "Chart to list, for example top_albums." }, "country": { "type": "string", "default": "United States", "description": "Country name or two-letter code, for example Canada or CA." }, "max_results": { "type": "integer", "default": 50, "maximum": 100, "minimum": 1, "description": "Number of entries, for example 25 (maximum 100)." } } } ``` ## Output schema ```json { "type": "object", "required": [ "items" ], "properties": { "items": { "type": "array", "items": { "type": "object", "required": [ "rank", "title", "artist", "genre", "release_date", "cover_image_url", "apple_music_url", "apple_id" ], "properties": { "rank": { "type": "integer", "description": "Position in the chart." }, "genre": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "artist": { "type": [ "string", "null" ] }, "apple_id": { "type": [ "string", "null" ] }, "release_date": { "type": [ "string", "null" ], "description": "Release date in YYYY-MM-DD format." }, "apple_music_url": { "type": [ "string", "null" ] }, "cover_image_url": { "type": [ "string", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [Apple API: List top App Store charts](https://fous.com/methods/apps.apple.com/list-top-charts.md): Lists ranked iPhone or iPad apps from the public App Store charts for a chart, category, and country. App bundles and apps that are no longer available are left out. - [Apple API: List top podcasts](https://fous.com/methods/podcasts.apple.com/list-top-podcasts.md): Lists Apple Podcasts chart entries in rank order for a country and category, as top shows or top episodes. - [Apple API: Search songs](https://fous.com/methods/music.apple.com/search-songs.md): Searches the Apple Music song catalog by title and artist words, returning matching tracks in relevance order with prices and previews when available. - [Apple API: Get artist](https://fous.com/methods/music.apple.com/get-artist.md): Gets an Apple Music artist profile by name or artist link. The profile includes the latest release, top songs and albums. - [Apple API: Search podcasts](https://fous.com/methods/podcasts.apple.com/search-podcasts.md): Finds Apple Podcasts shows by name or topic in a country, ordered by search relevance, with ratings when the show page provides them. - [Apple API: Get album](https://fous.com/methods/music.apple.com/get-album.md): Finds an Apple Music album by title and optional artist, or by album link, and returns its matched release, purchase details and tracks in order. - [Apple API: Search apps](https://fous.com/methods/apps.apple.com/search-apps.md): Finds iPhone and iPad apps by keyword in a chosen country's App Store, with ratings, prices, categories and App Store links. - [Apple API: Get podcast reviews](https://fous.com/methods/podcasts.apple.com/get-podcast-reviews.md): Gets a podcast's country-specific rating total and average, plus up to 500 listener reviews sorted by newest or most helpful. - [All Apple methods](https://fous.com/methods/apple.com.md)