Social

YouTube search

YouTube search results — videos, Shorts, channels, and playlists in page order, with estimated total, per-result views / age / length / channel, and YouTube's own filters (type, upload date, duration, relevance vs popularity). Content and keyword research for video. Accepts the same query you would type into YouTube.

Credits: 1 (refunded on failure).

get/api/v1/social/youtube/search

Request

  • Base URL: https://scrapewhale.dev
  • URL: https://scrapewhale.dev/api/v1/social/youtube/search
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Query parameters

qstring required

Search query.

sort'relevance' | 'popularity'

relevance (default) or popularity. YouTube web search no longer offers upload-date or rating sorts — use upload_date to restrict recency.

type'video' | 'shorts' | 'channel' | 'playlist' | 'movie'

Restrict to video, shorts, channel, playlist, or movie.

upload_date'today' | 'week' | 'month' | 'year'

Uploaded within: today, week, month, or year.

duration'short' | 'medium' | 'long'

short (< 3 min), medium (3–20 min), or long (> 20 min).

max_pagesinteger

Result pages to fetch (1–5), ~20 items each. Default 1.

format'json' | 'markdown' | 'both'

Response shape: "json" (structured data only), "markdown" (markdown only), or "both".

Response

Success.

idstring required
status'completed' required
extractorstring required

Extractor name, e.g. "traffic", "meta-ads", "instagram-profile".

titlestring nullable
sourceUrlstring nullable

Canonical public URL of the extracted source.

creditsChargedinteger required

0 when served from the shared cache.

cachedboolean

True when served from the shared extraction cache (free).

createdAtinteger required

Unix epoch milliseconds.

dataobject nullable

Raw structured payload from the source.

markdownstring

Clean markdown rendering of the payload.

Changes

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