# YouTube API: List top songs chart > Lists the latest weekly YouTube Music Top Songs chart for a country or globally, with ranks, weekly views and video links. Unofficial. Not affiliated with or endorsed by YouTube. - Page: https://fous.com/methods/youtube.com/list-top-songs - Method: `youtube.com/list_top_songs`, version 1 - Website: youtube.com - Returns: week dates, ranked songs with artists, weekly views, weeks on chart, video link - 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 | |---|---|---|---|---| | `country` | string | no | `"Global"` | Country name or two-letter code, or Global. For example, United States. Default "global". | | `max_results` | integer | no | | Maximum number of ranked songs to return, for example 25. Default 100. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "country": "Global" } ``` Its output: ```json { "songs": [ { "rank": 1, "artists": [ "Shakira", "Burna Boy" ], "song_title": "Dai Dai", "video_link": "https://www.youtube.com/watch?v=fcnDmrtj6Sk", "weekly_views": 47942059, "previous_rank": 1, "weeks_on_chart": 22 }, { "rank": 2, "artists": [ "ARJN", "KDS", "FIFTY4" ], "song_title": "KALYANI (Remix)", "video_link": "https://www.youtube.com/watch?v=xvT1jH8B9AM", "weekly_views": 39758870, "previous_rank": 2, "weeks_on_chart": 26 }, { "rank": 3, "artists": [ "KAROL G", "Judeline", "rusowsky" ], "song_title": "BbY WOW", "video_link": "https://www.youtube.com/watch?v=fRIhCiUVaKs", "weekly_views": 29626337, "previous_rank": 3, "weeks_on_chart": 8 } ], "week_end_date": "2026-10-15", "week_start_date": "2026-10-09" } ``` ## 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":"youtube.com/list_top_songs","input":{"country":"Global"}}' ``` 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 songs on YouTube Music this week in the United States? - Show me the global YouTube Music top songs chart with weekly views and weeks on chart - Which tracks are ranking highest on the YouTube Music charts in Japan right now? - Give me the latest weekly top 50 songs for Brazil with artists and video links - Can you pull up the current YouTube top songs list for the UK, ranked, with view counts? ## Input schema ```json { "type": "object", "required": [], "properties": { "country": { "type": "string", "default": "global", "description": "Country name or two-letter code, or Global. For example, United States." }, "max_results": { "type": "integer", "default": 100, "maximum": 100, "minimum": 1, "description": "Maximum number of ranked songs to return, for example 25." } } } ``` ## Output schema ```json { "type": "object", "required": [ "week_start_date", "week_end_date", "songs" ], "properties": { "songs": { "type": "array", "items": { "type": "object", "required": [ "rank", "previous_rank", "song_title", "artists", "weekly_views", "weeks_on_chart", "video_link" ], "properties": { "rank": { "type": "integer" }, "artists": { "type": "array", "items": { "type": "string" } }, "song_title": { "type": "string" }, "video_link": { "type": "string" }, "weekly_views": { "type": "integer" }, "previous_rank": { "type": [ "integer", "null" ] }, "weeks_on_chart": { "type": "integer" } }, "additionalProperties": false }, "description": "Top songs in chart rank order." }, "week_end_date": { "type": "string", "format": "date", "description": "Last day of the chart week." }, "week_start_date": { "type": "string", "format": "date", "description": "First day of the chart week." } }, "additionalProperties": false } ``` ## See more - [YouTube API: List channel videos](https://fous.com/methods/youtube.com/list-channel-videos.md): Lists a YouTube channel's public videos, Shorts, or live uploads, newest first or most popular first, along with channel details. Counts and dates taken from displayed text may be approximate. - [YouTube API: Get video comments](https://fous.com/methods/youtube.com/get-video-comments.md): Gets public top-level comments on a YouTube video, found by link, video ID or title. Reply text is not included. - [YouTube API: Get video](https://fous.com/methods/youtube.com/get-video.md): Gets public details and statistics for one YouTube video by link, ID or title. A title selects the top search match. - [YouTube API: Find a company's channel](https://fous.com/methods/youtube.com/find-company-channel.md): Finds a company's verified YouTube channel by name and returns its name, link, subscriber count, description, country and official website when identifiable. - [YouTube API: Get channel](https://fous.com/methods/youtube.com/get-channel.md): Gets a public YouTube channel's profile, links and statistics from its name, @handle or link. Subscriber totals may be rounded as YouTube displays them. - [YouTube API: Get video transcript](https://fous.com/methods/youtube.com/get-video-transcript.md): Returns the spoken captions and timed segments of a YouTube video, given a video link or a title (top search match). Only captions the video has are returned. - [Kworb API: Get YouTube music chart](https://fous.com/methods/kworb.net/get-youtube-music-chart.md): Gets Kworb's latest YouTube music chart, worldwide or for one country, ordered by daily views. The worldwide chart covers the past 24 hours. Country charts report daily track streams. - [Apple API: List top charts](https://fous.com/methods/music.apple.com/list-top-charts.md): 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. - [All YouTube methods](https://fous.com/methods/youtube.com.md)