The YouTube videos your agent needs.
YouTube Search returns videos, channels, playlists and Shorts for a query. Control it by type, duration, upload date and features.
terminal
YouTube APIfor AI agents
One API for YouTube data. Get videos, transcripts, comments and channels as JSON.
The YouTube endpoints.
- YouTube Search APIOne API call to search YouTube. Get videos, channels and playlists as JSON.
- YouTube Transcript APIOne API call to read a YouTube video. Get the transcript as text or as segments.
- YouTube Video APIOne API call to get a YouTube video's details. Get stats, tags and chapters as JSON.
- YouTube Comments APIOne API call to read YouTube comments. Get comments and replies as JSON.
- YouTube Channel APIOne API call to read a YouTube channel. Get its profile and videos as JSON.
- YouTube Channel Search APIOne API call to search inside a YouTube channel. Get the matching videos as JSON.
- YouTube Related Videos APIOne API call to get a video's Up next list. Get the related videos as JSON.
- YouTube Hashtag APIOne API call to read a YouTube hashtag page. Get its videos as JSON.
- YouTube Community Post APIOne API call to read a YouTube community post. Get the post and its comments as JSON.
- YouTube Charts APIOne API call to get YouTube Charts. Get top songs, videos and artists as JSON.
- YouTube Playlist APIOne API call to read a YouTube playlist. Get its details and videos as JSON.
- YouTube Autocomplete APIOne API call to get YouTube search suggestions. Get keywords in rank order as JSON.
How agents use it.
Summarize what videos say
The agent calls youtubeSearch with a topic, then youtubeTranscript with each videoId. It gives the text to a model and gets one summary of several videos.
Audit a channel
The agent calls youtubeChannel with tab set to videos and sort set to popular. It then calls youtubeVideo with each videoId to read the likes, the tags and the chapters.
Read how viewers react
The agent calls youtubeChannelSearch to find a channel's videos on one topic. It then calls youtubeComments on each video and reads the comments with the most likes.
Free YouTube tools.
- Free YouTube Transcript GeneratorA video's captions as text, with a start time for each line.
- Free YouTube Comment DownloaderA video's top comments with author, likes and date, as a list or a .csv file.
- Free YouTube Tag ExtractorThe tags the uploader set on a video.
- Free YouTube Video StatsA video's views, likes, comment count, length and publish date.
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 call Stophy, so you need no Google Cloud project and no YouTube Data API key. youtube.search, youtube.transcript, youtube.video and youtube.comments work without a Stophy API key, and a free daily limit applies. Without a key, a search and a comment list return the first page only. The other endpoints need a Stophy API key.
Videos, transcripts, comments, channels, playlists, community posts and charts. A video has videoId, title, channelName, durationSeconds, views, likes, tags and chapters. A transcript has text, language and isAutoGenerated, plus segments with startSeconds and endSeconds when you set includeTimestamps. A channel has subscribers, videos and totalViews.
No. The endpoints read public YouTube data. They do not upload videos, post comments, like or subscribe. They do not sign in to a Google account, so they return no private videos and no watch history.
The list endpoints return a cursor. Send it in the next call with the same inputs. youtube.charts has no pages: set limit, from 1 to 100, to choose how many entries you get. youtube.transcript, youtube.video and youtube.suggest return one answer for each call.
1 credit for each call that returns data. youtube.charts is the exception: it costs 1 credit for every 10 results, so set limit to cap the cost. A call that returns an error or an empty list uses 0 credits.
Connect the agent to https://mcp.stophy.dev/mcp and sign in with your browser. To use an API key, connect to https://api.stophy.dev/mcp and send the header Authorization: Bearer <key>. The agent calls each endpoint by its id in camelCase. For example, youtube.transcript is youtubeTranscript and youtube.channel.search is youtubeChannelSearch.
Get started
Give your agent the web today.
Sign up for 1,000 free credits. No card needed.