Description
This endpoint retrieves comprehensive information about a YouTube video including metadata, statistics, channel information, and optionally the video transcript. Works with both regular videos and shorts.Endpoint
Headers
- Content-Type: application/json
- Authorization: Bearer <API_KEY>(required)
Request Body
Responses
Success (200)
Returns complete video information including metadata, statistics, and optionally transcript data.- Content-Type: application/json
- X-RateLimit-Limit: The rate limit for the user
- X-RateLimit-Remaining: The remaining number of requests for the user
Bad Request (400)
Returned if the request is invalid or missing required parameters.Bad Gateway (502)
Returned if the external service is unavailable or returns invalid data.Internal Server Error (500)
Returned if there’s an unexpected server error.Example Request
Example Response
Notes
- The urlparameter must be a valid YouTube video or short URL
- When get_transcriptis set totrue, transcript data will be included if available
- Transcripts are only available for videos that have captions enabled
- The response includes comprehensive video metadata, statistics, and channel information
- watchNextVideoscontains suggested videos that YouTube recommends
- transcript_only_textprovides the full transcript as a single concatenated string
- This endpoint uses 1 credit per request
Rate Limiting
Rate limit headers (X-RateLimit-Limit and X-RateLimit-Remaining) are included in the response to indicate the user’s current rate limit status.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Full YouTube video URL.
When true, include transcript segments.
Optional identifier describing where the API request originated.
Available options: 
API, WEB, MAKE_DOT_COM, ZAPIER, N8N, PLAYGROUND, DEFAULT_AUTOMATION, AGENT_PREVIEW, AGENT_LIVE, AUTOPILOT, STUDIO Response
Video details retrieved.