Skip to main content
POST
Get YouTube video

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 url parameter must be a valid YouTube video or short URL
  • When get_transcript is set to true, 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
  • watchNextVideos contains suggested videos that YouTube recommends
  • transcript_only_text provides the full transcript as a single concatenated string
  • This endpoint uses 10 credits 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

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
url
string<uri>
required

Full YouTube video URL.

get_transcript
boolean

When true, include transcript segments.

requestSource
enum<string>

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.

id
string
thumbnail
string<uri>
type
string
title
string
description
string
commentCountText
string | null
commentCountInt
integer | null
likeCountText
string | null
likeCountInt
integer | null
viewCountText
string | null
viewCountInt
integer | null
publishDateText
string | null
publishDate
string<date-time> | null
channel
object
durationMs
integer | null
durationFormatted
string | null
watchNextVideos
object[]
keywords
string[]
transcript
object[]
transcript_only_text
string | null