YouTube
YouTube charts API
Get YouTube Charts: top songs, videos, artists, Shorts songs, podcasts or trending. Call the YouTube charts API for JSON. From 1 credit per call.
POST
Get YouTube Charts: top songs, videos, artists, Shorts songs, podcasts or trending
Returns YouTube Charts: top songs, videos, artists, Shorts songs, podcasts or trending.
Request
This method has no required parameters.Response
If successful, the response body contains the standard envelope.data.results[] contains the chart entries in order, each with its position.
The following example is a real response, truncated: each list shows one item and long strings are cut.
For every field, see the response schema on this page.
Optional parameters
Billing
A successful request consumes 1 credit per 10 results, up to 10 credits. Requests that fail, or that return no items, are not billed. Setlimit to cap the number of items returned and billed.
Pagination
This method is not paginated. A single request returns the complete result.Related methods
- YouTube transcript: Accepts
videoUrl. Returns what a YouTube video says, from its captions. - YouTube video: Accepts
videoUrl. Returns a video’s stats, description, chapters and most replayed moments. - YouTube comments: Accepts
videoUrl. Returns a video’s comments, or the replies to one comment. - YouTube channel: Accepts
channelUrl. Returns a channel’s profile and one tab of videos, shorts, live, playlists, podcasts or posts.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
YouTube Charts' own chart.
Available options:
topSongs, topVideos, topArtists, topShortsSongs, topPodcasts, trending One of YouTube Charts' own countries as a 2-letter code, or global.
Daily exists for topVideos and topShortsSongs only.
Available options:
weekly, daily Return at most this many results. You pay 1 credit per 10 returned.
Required range:
1 <= x <= 100