The YouTube charts your agent needs.
YouTube Charts returns top songs, videos, artists, Shorts songs, podcasts or trending. Choose the chart, the country and the interval.
terminal
YouTube Charts APIfor AI agents
One API call to get YouTube Charts. Get top songs, videos and artists as JSON.
What people use it for.
Find rising songs
Compare position with previousPosition on each entry. A large jump marks a song that is rising this week.
Compare countries
Get topSongs for several countries and compare the titles. You see which songs are local and which are global.
Plan content from trends
Set chart to trending and limit to 10. Give the titles to an agent that plans what to post today.
More YouTube endpoints.
- SuggestionsGet YouTube search suggestions for a keyword
- SearchSearch YouTube videos, channels, playlists and shorts
- TranscriptGet what a YouTube video says, from its captions
- VideoGet a video's stats, description, chapters and most replayed moments
- CommentsGet a video's comments, or the replies to one comment
- ChannelGet a channel's profile and one tab of videos, shorts, live, playlists, podcasts or posts
- Channel searchSearch one channel's videos, like the search box on its YouTube page
- Related videosGet the videos YouTube suggests next to a video, like its Up next list
- HashtagGet the videos on a YouTube hashtag page, like youtube.com/hashtag/sourdough
- PostGet a YouTube community post and its comments
- PlaylistGet a playlist and a page of its videos
- All YouTube endpointsOne API for YouTube data. Get videos, transcripts, comments and channels as JSON.
Ways to call it.
- Use the APISend a POST request with a Bearer key. Every endpoint returns success, data, creditsUsed and requestId.
- Use MCPAdd https://api.stophy.dev/mcp to Claude, Cursor or Codex. The agent finds an endpoint and calls it.
- Use the SDKInstall the TypeScript or Python client. Call an endpoint by its id, such as youtube.transcript.
- Use the CLICall an endpoint from the terminal. The CLI prints JSON, so you can pipe the result into a script.
Start free. Pay per call after.
No plans and no monthly fee. 1,000 free credits to start, then $1.50 per 1,000 credits, $1.20 from $100 and $0.80 from $500. Credits never expire.
Free
Every account starts with free credits. No card needed.
1,000 free credits
$0
- ✓Every source
Pay as you go
Add credits to your balance and spend them one call at a time.
$1.50 per 1,000 credits, $1.20 from $100 and $0.80 from $500
$0.0015/ credit
10,000 credits≈ $13.50
Most calls cost 1 credit.
- ✓Never expires
Custom
For teams that need higher rate limits or a source we do not cover yet.
Volume pricing
Custom
- ✓Custom rate limits
- ✓New sources on request
- ✓Direct support
Questions and answers.
No. You send a Stophy API key and choose a chart. You need no YouTube Data API key, and you do not download chart files by hand.
chart takes topSongs, topVideos, topArtists, topShortsSongs, topPodcasts or trending. The default is topSongs.
The chart, the country, a throughDate and a results list. Each entry has position, previousPosition, periodsOnChart, viewsChangePercent, title, artists, views and videoUrl.
Set country to a two-letter code such as us, or to global. Set interval to weekly or daily. A daily chart exists for topVideos and topShortsSongs only.
1 credit for every 10 results returned. Set limit, from 1 to 100, to cap the count. With limit set to 20, a call costs at most 2 credits. A call that returns an error uses 0 credits.
No. One call returns the chart. Use limit to choose how many entries you get.
Yes. Add the MCP server at https://api.stophy.dev/mcp to Claude, Cursor or Codex. The agent calls the endpoint by the id youtubeCharts.
Get started
Give your agent the web today.
Sign up for 1,000 free credits. No card needed.