Skip to main content

YouTube

The YouTube connector exposes six endpoints:

EndpointPurposeBilled
GET /v1/youtube/searchKeyword/topic search across public videosper result block
GET /v1/youtube/video/{video_id}A single video's details and metricsper request
GET /v1/youtube/video/{video_id}/commentsA video's comments, optionally with repliesper result block
GET /v1/youtube/video/{video_id}/transcriptA video's transcript as timestamped segmentsper request
GET /v1/youtube/video/{video_id}/transcriptsThe transcript tracks a video offersper request
GET /v1/youtube/channel/{channel_id}A channel's reference data and metricsper request

Identifiers​

Video id — the 11-character code from a watch URL:

https://www.youtube.com/watch?v=dQw4w9WgXcQ
└─────────┘
video_id = dQw4w9WgXcQ

Channel — the video and channel endpoints accept either a channel id or a handle:

  • Channel id — UC38IQsAvIsxxjztdMZQtwHA
  • Handle — @google

Result types​

typeMeaning
videoA standard video or Short
channelA channel record

Metrics vocabulary​

Counts are returned both as a number and as the display string shown on YouTube, so you get a precise value and the human-readable form:

FieldMeaning
views / views_textView count, e.g. 184203 and 184K views
subscribers / subscribers_textSubscriber count, e.g. 1230000 and 1.23M subscribers
view_count / view_count_textChannel total views
video_count / video_count_textChannel public video count
like_count / like_count_textLike count — on a video or a comment
comment_countTotal comments on a video
Why some fields are null

A count that YouTube does not expose is returned as null, never 0, so you can always tell missing apart from zero. Subscriber counts are rounded by YouTube itself.

Latency & reliability​

  • The first request after a quiet period may be slower; subsequent requests are faster.
  • Occasional 429 upstream_rate_limited responses indicate a transient block — retry with backoff and it will clear. See Errors.
  • Large max_results values run more work; prefer modest counts and page over multiple calls for big pulls.