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

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 "lr=lang_fr|lang_en"

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

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 "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"

uule ,UULE(Optional)

Encodes the target location via Base64. Use with location.

Example Request:

Example results for q : pizza,location:India,uule:w+CAIQICIFSW5kaWE

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 "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"

Pagination

start ,Result offset(Optional)

Sets the starting result index (default: 0).

Example Request:

Example results for q : pizza,start:30

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 "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

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 "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

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 "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

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 "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

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 "nfpr=1"

filter ,Results Filtering(Optional)

Deduplicates results: 1 (enable), 0 (disable).

Code Example:

Example results for q : pizza,filter:1

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 "filter=1"

For further assistance, contact us at [email protected].