Search YouTube videos or channels

Provide 'q' for a first page, or 'page_token' (from a previous response's data.continuation_token) to continue. 'type' restricts results to one kind - it does not mix both.

get/search

Request

  • Base URL: https://getyoutubetranscript.com/api/v1
  • URL: https://getyoutubetranscript.com/api/v1/search
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Query parameters

qstring

Search query. Required unless 'page_token' is set.

page_tokenstring

Short opaque cursor (data.continuation_token) from the previous page. Do not construct it. Expires after 24 hours; a 400 CURSOR_EXPIRED means start again from the first page.

type'video' | 'channel'

'video' (default) or 'channel'.

countrystring

Two-letter region code, e.g. us.

languagestring

Result language hint, e.g. en.

limitinteger

Max results for this page.

Response

Search results.

Changes

No recorded changes to this operation across all 1 revision of this API.