Search YouTube
zenserp_youtube_searchDestructive
YouTube search results (videos, channels, ads) for a query, optionally by location. SPENDS 1 request of the monthly quota per successful call (failed calls are not charged); do not repeat a call needlessly. GET /v2/search (search_engine=youtube.com).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | The query. | |
| gl | No | Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States. | |
| hl | No | Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes. | |
| sp | No | YouTube 'sp' filter or pagination token, as used on youtube.com. | |
| cache | No | true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged. | |
| fields | No | Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same. | |
| location | No | Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads. |