YouTube

Search YouTube

Videos matching a query, with what you need to choose one: title, channel, length, views, publish date, licence (YouTube standard or Creative Commons), whether captions exist. Filter by length, licence, captions, language, country, date or channel. Give a result's url to POST /v1/ai/text as media and the model watches the video in place (moments with timestamps, a summary, a script). Nothing is downloaded. To cut or dub a video you need the file: your own videos (YouTube Studio → download → POST /v1/studio/uploads) or Creative Commons ones, with the credit line on screen. Dubbing into another language: /skills/full-dub-video.md. A vertical reel of it (or a commentary on your own footage when you have no licence): /skills/full-youtube-reel.md.

Billing: Read request (one YouTube search = 100 of the daily quota units) · Rate limit: 30/min

get/v1/youtube/search

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/youtube/search
  • Auth: HTTP bearer

Query parameters

qstring required

What to look for — any language

limitinteger
order'relevance' | 'date' | 'views' | 'rating'
regionstring

Country code, e.g. IL

license'any' | 'creative-commons'

creative-commons = videos their owners released under CC BY (reusable with the credit line)

captions'any' | 'yes'

yes = only videos with captions

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

short < 4 min · medium 4–20 min · long > 20 min

languagestring

Prefer results in this language (he, en, ar, ru…)

channel_idstring

Only this channel

published_afterstring

ISO date — only newer videos

Headers

Idempotency-Keystring

Replay-safe: the same execution is returned instead of charging twice

X-Tagstring

Group calls into one job (e.g. one video) — see GET /v1/usage?tag=…

Response

Completed

idstring

Execution id — stable across internal retries; use it with GET /v1/executions/{id}

status'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
operationstring
tagstring nullable

Your X-Tag, if sent

created_atstring date-time
completed_atstring date-time nullable
outputobject

Operation result (see each operation). While a Studio render is processing: stage (queued · transcribing · downloading · preparing · cleaning_voice · mixing_audio · rendering · finishing), phase (the engine's: download · prepare · voice · audio · encode · qa · upload, or null), progress (a percent, 0–100) and progress_fraction (0–1), eta_seconds (seconds left, never below 0) and estimate_seconds

errorstring nullable

Changes

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