Search YouTube
social_youtube_search is a $0.20 GET request on the Wuthering AI API. Find videos ranking for a search term, with view counts and channels. It answers complete JSON, and a call that fails is not charged.
Endpoint
GET /v1/social_youtube_search
Price per successful call
$0.20
Failed calls
Not charged
curl 'https://wutheringai.com/v1/social_youtube_search?keyword=…&token=YOUR_TOKEN'
What does social_youtube_search return, and when should you call it?
Search YouTube for a term and return the ranked video results.
View counts on tutorial and comparison videos are a durable demand signal: people only watch a twenty-minute setup walkthrough for a problem they actually have. Pair a result's video_id with wuthering_social_youtube_subtitles to read what was said.
Returns: video_id, title, channel_name, channel_url, views_count, publication_date, duration_time, description, url, rank_absolute.
Use to find the videos shaping how buyers understand a category. Don't use for web pages, which is wuthering_web_search.
What parameters does social_youtube_search take?
social_youtube_search accepts 3 parameters, of which 1 is required. Array values are comma-separated on the query string.
| Parameter | Type | Required | Description |
|---|---|---|---|
| keyword | string | yes | Search term to look up on YouTube. |
| location_code | number | no | Numeric location code to scope results to. Defaults to 2840 (United States). Search volume and competition vary sharply by country, so set this when the question is about a specific market.Defaults to 2840 |
| language_code | string | no | ISO language code for results, for example 'en' or 'de'. Defaults to 'en'.Defaults to en |
Which playbooks call social_youtube_search?
3 of the research playbooks name social_youtube_search in their method. Each is free to read and says where in the sequence the call belongs.
- Who are we really up against?Work April Dunford's positioning sequence from public evidence: the alternatives a prospect would actually use, what only you do, the value that follows, who cares most, and the category that makes all of it obvious.
- Where do the next 1,000 customers come from?Score every plausible channel against the product's own characteristics, measure the reachable demand and the cost of entry for each, and commit to one with its CAC and its ceiling stated.
- What should we build next?Gather the language of people switching into and out of this category, code every quote to the force that drives it, size each theme against real search demand, and return a 50/50 roadmap.
Reference for social_youtube_search · last updated · published by Wuthering AI