Skip to main content
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. Set limit to cap the number of items returned and billed.

Pagination

This method is not paginated. A single request returns the complete result.
  • 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

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
chart
enum<string>
default:topSongs

YouTube Charts' own chart.

Available options:
topSongs,
topVideos,
topArtists,
topShortsSongs,
topPodcasts,
trending
country
string
default:us

One of YouTube Charts' own countries as a 2-letter code, or global.

interval
enum<string>
default:weekly

Daily exists for topVideos and topShortsSongs only.

Available options:
weekly,
daily
limit
integer

Return at most this many results. You pay 1 credit per 10 returned.

Required range: 1 <= x <= 100

Response

The data, and the credits this call used.

success
any
required
data
object
required
creditsUsed
integer
required
requestId
string
required