Introduction
The YouTube context API for AI agents — search, transcripts, comments, channels, and playlists as JSON.
Stophy is the YouTube context API for AI agents.
Search videos, pull timestamped transcripts, read threaded comments, inspect channels, and fetch playlists from one API. Every successful request returns structured JSON and deducts the documented number of credits.
Base URL
https://api.stophy.devEndpoints
Video
Transcripts with timestamps, comments, reply threads, and video metadata.
Search
Ranked results with full metadata. Filter by type, recency, duration, and features.
Channel
Videos, shorts, playlists, about. One parameter switches tabs.
Playlist
Every video in any playlist. Paginated.
Credits & Usage
Pay per request. No subscriptions. Track balance, logs, and daily usage.
How it works
Every request to a /v1/* endpoint:
- Authenticates with your API key (
Authorization: Bearer $STOPHY_API_KEY) - Deducts one credit on success
- Returns a consistent JSON envelope with
success,requestId,cacheState,creditsUsed(always1for data requests),creditsRemaining, anddata
Get started
Quickstart
Copy your default dashboard key and make your first request.
Authentication
How API keys work.
Error Handling
Error codes and how to handle them.