Google Videos
SERP API Google Query Parameters
Configure Google Videos queries using Thordata’s SERP API, including localization parameters, geotargeting, pagination, and "advanced filters" output options.
q ,Search Query(Required)
Define the search query used for data crawling (default value: q=pizza). Any keywords in any language are supported.
Example Request:
Example with q:pizza parameter
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_videos" \
-d "q=pizza" \
-d "json=1"Localization
google_domain,Domain(Optional)
Defines the domain used for scraping. Default: google.com.
Modify this or refer to the Google Domains page for a full list of supported domains.
Example Request:
Example results for q : pizza ,google_domain: google.co.ao
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_videos" \
-d "q=pizza" \
-d "google_domain=google.co.ao" \
-d "json=1"gl ,Country(Optional)
Specifies the country/region for localized search results (default: us). Uses a two-letter country code (e.g., us, ru, uk).
For supported codes, see Google’s Country List.
Example Request:
Example results for q : pizza,gl: ru
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_videos" \
-d "q=pizza" \
-d "gl=ru" \
-d "json=1"hl ,Language(Optional)
Sets the UI language for search results (default: en). Uses a two-letter language code (e.g., en, es, zh-CN).
Full list: Google Language Codes.
Example Request:
Example results for q : pizza,hl: es
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_videos" \
-d "q=pizza" \
-d "json=1" \
-d "hl=es"lr ,Set Multiple Languages(Optional)
Filters results by language using lang_XX codes (e.g., lang_fr|lang_de). Overrides hl if both are used.
hl andlr can be used together, but the actual effect followslr as the priority.
Example Request:
Example results for q : pizza,lr: lang_en|lang_fr
Geotargeting
location ,Location(Optional)
Simulates searches from a precise location. Must be paired with uule. If omitted, the proxy’s location may be used.
Example Request:
Example results for q : pizza,location:India,uule:w+CAIQICIFSW5kaWE
uule ,Encoded Location(Optional)
Encodes the target location via Base64. Use with location.
Example Request:
Example results for q : pizza,location:India,uule:w+CAIQICIFSW5kaWE
Pagination
start ,Result offset(Optional)
Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 10 is the 2nd page of results, 20 is the 3rd page of results, etc.).
Google Local Results only accepts multiples of 20(e.g. 20 for the second page results, 40 for the third page results, etc.) as the start value.
Example Request:
Example results for q : pizza,start:30
num ,Results per page(Optional)
Sets the number of results per page (default: 20).
Example Request:
Example results for q : pizza,num:20
Advanced Filters
tbs ,Advanced Search Parameters(Optional)
Advanced filters:
Time:
qdr:h(1 hour),qdr:y(1 year)Content:
sur:f(images),sur:fc(free-to-use images)
Code Example:
Example results for q : pizza,tbs:sur:f
safe ,Safe(Optional)
Filters adult content:
safe=active– Strict filtering (default)safe=off– No filtering
Example Request:
Example results for q : pizza,safe:active
nfpr ,Exclude Auto-corrected Results(Optional)
Disables autocorrect (e.g., nfpr=1 prevents "googl" → "google").
Code Example:
Example results for q : pizza,nfpr:sur:f
filter ,Results Filtering(Optional)
Deduplicates results: 1 (enable), 0 (disable).
Code Example:
Example results for q : pizza,filter:1
For further assistance, contact us at [email protected].
Last updated