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 Search APIfor AI agents
One API call to search YouTube. Get videos, channels and playlists as JSON.
What people use it for.
Research a topic from talks
Search a topic with duration set to over20Minutes. Pass each videoId to youtube.transcript and give the text to a model.
Find creators in a niche
Set type to channels and read subscribers on each result. You get a list of creators who cover a subject.
See what is new this week
Set uploadDate to thisWeek and prioritize to popularity. The views field shows which new videos grow fastest.
More YouTube endpoints.
- SuggestionsGet YouTube search suggestions for a keyword
- 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
- ChartsGet YouTube Charts: top songs, videos, artists, Shorts songs, podcasts or trending
- 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 call Stophy, so you need no Google Cloud project and no YouTube Data API key. The first page of a search needs no key at all, and a free daily limit applies. To get later pages, send a Stophy API key.
A results list and a cursor. Each result has a type. A video has videoId, videoUrl, title, channelName, durationSeconds, views, publishedAt, isShort and isLive. A channel has subscribers. A playlist has playlistId and its video count in videos.
type takes videos, shorts, channels, playlists or movies. duration takes under3Minutes, 3to20Minutes or over20Minutes. uploadDate takes today, thisWeek, thisMonth or thisYear. features is a list with values such as live, 4k, hd, subtitles and creativeCommons.
Set prioritize to popularity. The default is relevance, which is the order YouTube shows for the query.
Send the cursor from the last response. Keep the same query, type, duration and uploadDate. A request with a cursor needs an API key.
1 credit for each call that returns data. A call that returns an error or an empty list uses 0 credits.
Yes. Add the MCP server at https://api.stophy.dev/mcp to Claude, Cursor or Codex. The agent calls the endpoint by the id youtubeSearch. The agent can then pass a videoId to youtubeTranscript to read what the video says.
Get started
Give your agent the web today.
Sign up for 1,000 free credits. No card needed.