YouTube

Search YouTube videos

get/youtube/search

Request

  • Base URL: https://scrappa.co/api
  • URL: https://scrappa.co/api/youtube/search
  • Auth: API key in header X-API-KEY

Query parameters

querystring nullable

Search query

limitinteger nullable

Number of results (default: 10, max: 20)

pageinteger nullable

Page number (default: 1, max: 10)

continuationstring nullable

Token for pagination from previous response

hlstring nullable

Language code (e.g., en).

glstring nullable

Country code (e.g., US).

type'video' | 'channel' | 'playlist' | 'movie' | 'all' | 'null' nullable

Filter by content type: video, channel, playlist, movie, all (default: all).

order'date' | 'rating' | 'relevance' | 'viewCount' | 'null' nullable

Sort order: date, rating, relevance, viewCount.

videoDuration'short' | 'medium' | 'long' | 'null' nullable

Filter by duration: short, medium, long.

publishedAfterstring date-time nullable

Return videos published after a date/time (best-effort; any valid date string, RFC3339 recommended).

publishedBeforestring date-time nullable

Return videos published before a date/time (best-effort; any valid date string, RFC3339 recommended).

safeSearch'moderate' | 'none' | 'strict' | 'null' nullable

Content filtering: moderate, none, strict.

Response

querystring required

Changes

No recorded changes to this operation across all 3 revisions of this API.