google_videos
Retrieve Google video search results with localized and filtered queries. Supports pagination, country/language settings, and time filters.
Instructions
Retrieves Google video search results with geographic localization, language preferences, and advanced filtering. Costs 5 API credits per request. [Credits: 5 API credits per request] Notes: Pagination via page (0-indexed). Returns: { video_results: [{title, thumbnail, link, displayed_link, time, rank}] }
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lr | No | Limit search to one or multiple languages, formatted lang_{language code}, e.g. lang_us. | |
| tbs | No | Advanced parameter ('to be searched') to filter search results. | |
| html | No | Return the response as raw HTML instead of JSON. (default: false) | |
| nfpr | No | Set 1 to exclude auto-corrected/misspelled-query results, 0 to include them. (default: 0) | |
| page | No | Page number of Google search results. 0 = first page, 1 = second page, etc. (default: 0) | |
| safe | No | Adult content filter. Allowed values: active, off. (default: off) | |
| uule | No | Encoded geographic location/locale to tailor results, e.g. w+CAIQIFJlbGF5IFN0YXRlcw==. | |
| query | Yes | Google query. Example: query=shoes | |
| domain | No | Google domain for local results, e.g. google.co.in for India, google.co.uk for the UK. (default: google.com) | |
| country | No | ISO country code for the Google search results. (default: us) | |
| language | No | Language of the results, e.g. en, es, fr, de. (default: en) | |
| result_time | No | Companion to the tbs parameter for time-range filtering (e.g. language, country, file type, etc). Example value: qdr:d. |