Search YouTube videos

Search for YouTube videos by keyword. Supports sorting by relevance, date, view count, or rating. Can optionally restrict to a specific channel. Use when user asks 'find YouTube videos about X', 'search YouTube for Y'. NOTE: Uses Google OAuth — if not authenticated, user must sign in with Google first.

get/api/v1/youtube/search

Request

  • Base URL: https://localhost:3000
  • URL: https://localhost:3000/api/v1/youtube/search
  • Auth: OAuth 2 (authorization code, authorization URL /oauth/authorize, token URL /oauth/token)

Query parameters

querystring required

Search query string

max_resultsinteger

Maximum results per page (default: 10)

order'relevance' | 'date' | 'viewCount' | 'rating'

Sort order: relevance, date, viewCount, rating

channel_idstring

Restrict search to a specific YouTube channel ID

page_tokenstring

Token from previous response for next page

Response

YouTube search results

userstring
providerstring
total_resultsinteger
next_page_tokenstring

Changes

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