YouTube Video search
searchSearch YouTube for videos matching a query
POST /v1/searchProviders
Every provider below returns the same normalized output. Pass a slug to pick one explicitly, or let SocialRouter route for you.
- Apify
apify/youtube/video.searchUp to 50 queries per request
$0.0055per record
Input
A free-text query (e.g. "machine learning tutorials"). Plain terms and YouTube search URLs are both accepted.
machine learning tutorialsOutput
Each record has the fields below, whichever provider serves the request. Providers may include additional platform-specific fields on top.
titlestringVideo title
video_idstringPlatform video ID
profile_urlurlCanonical video URL
descriptionstringVideo description / caption
durationstringLength of the video
thumbnailurlThumbnail image URL
viewsnumberView count
likesnumberLike count
num_commentsnumberComment count
date_postedstringWhen the video was published (raw platform string)
channel_namestringChannel name
channel_urlurlChannel URL
source_ordernumberRank in the result list (1 = top)
sourcestringPlatform the record was extracted from (e.g. "linkedin")
extracted_atiso8601UTC timestamp when the record was produced
How to call it
Pass a provider slug from the table above as the provider field on the POST /v1/search endpoint.
Frequently asked questions
How much does YouTube video search cost?
Prices start at $0.0055 per record, depending on the provider you route to. You are only charged for records actually returned.
Which providers offer YouTube video search?
Apify — 1 provider is available through SocialRouter's unified API. Pick one explicitly with its slug, or let the router choose.
What input does it need?
A free-text query (e.g. "machine learning tutorials"). Plain terms and YouTube search URLs are both accepted. For example: machine learning tutorials
Is the output format the same for every provider?
Yes. Every provider returns the normalized record schema documented on this page; some providers add extra platform-specific fields on top, but the documented fields are always present.
How many queries can I send per request?
Up to 50 queries in a single request, depending on the provider.
What happens if a provider fails?
SocialRouter automatically fails over to another provider offering the same service, so a single provider outage doesn't break your integration.