SERP API Google Query Parameters
Configure Google search queries using Thordata’s SERP API, including localization parameters, geotargeting, pagination, and "advanced parameter" output options.
q (Required)
This parameter defines the search query for scraping. The default value is q=pizza. You can input any keyword in any language.
Code Example:
Copy curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer xxxxxxxxxxxxxxxx" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1\"}" Localization
domain (Optional)
Defines the domain used for scraping. Default: google.com.
Modify this or refer to the
Example Request:
Copy curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer xxxxxxxxxxxxxxxx" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1\"}" gl (Optional)
Specifies the country/region for localized search results (default: us). Uses a two-letter country code (e.g., us, ru, uk).
Modifying gl affects ranking, localized content, and language preferences (e.g., gl=ru prioritizes Russian results). For supported codes, see
Example Request:
Copy curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer xxxxxxxxxxxxxxxx" -d "{\"url\": \"https://www.google.com/search?q=pizza^&gl=au^&json=1\"}" hl (Optional)
Sets the UI language for search results (default: en). Uses a two-letter language code (e.g., en, es, zh-CN).
Example Request:
Copy curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer xxxxxxxxxxxxxxxx" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&hl=es\"}" cr (Optional)
Restricts results to specific countries using | as a separator (e.g., countryFR|countryDE). Combine with gl for consistent UI/content language.
Example Request:
Copy curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer xxxxxxxxxxxxxxxx" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&cr=countryFR|countryDE\"}" lr (Optional)
Filters results by language using lang_XX codes (e.g., lang_fr|lang_de). Overrides hl if both are used.
Example Request:
Copy curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer xxxxxxxxxxxxxxxx" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&lr=lang_en|lang_fr\"}" Geotargeting
location (Optional)
Simulates searches from a precise location. Must be paired with uule. If omitted, the proxy’s location may be used.
Code Example:
Copy curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer xxxxxxxxxxxxxxxx" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&location=India^&uule=w+CAIQICIFSW5kaWE\"}" uule (Optional)
Code Example:
Copy curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer xxxxxxxxxxxxxxxx" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&location=India^&uule=w+CAIQICIFSW5kaWE\"}" Search Types
tbm (Optional)
Defines the search result type:
Code Example:
Copy curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer xxxxxxxxxxxxxxxx" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&tbm=shop\"}" start (Optional)
Sets the starting result index (default: 0). For example, start=30 skips the first 30 results.
Code Example:
Copy curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer xxxxxxxxxxxxxxxx" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&start=30\"}" num (Optional)
Sets the number of results per page (default: 20).
Code Example:
Copy curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer xxxxxxxxxxxxxxxx" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&num=50\"}" safe (Optional)
Filters adult content:
safe=active – Strict filtering (default)
Code Example:
Copy curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer xxxxxxxxxxxxxxxx" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&safe=active\"}" Advanced Parameters
ludocid (Optional)
Triggers Knowledge Graph data for specific entities (e.g., ludocid=14389889685039125943).
Code Example:
Copy curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer ab4a6ab147570ba7c5ea6f59990a458a" -d "{\"url\": \"https://www.google.com/search?q=Google^&json=1^&ludocid=14389889685039125943\"}" kgmid (Optional)
Directly calls a Knowledge Graph entry (e.g., /m/0d6lp for San Francisco).
Code Example:
Copy curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer xxxxxxxxxxxxxxxx" -d "{\"url\": \"https://www.google.com/search?q=Google^&json=1^&kgmid=/m/0d6lp\"}" ibp (Optional)
Controls special rendering modes (e.g., ibp=new for enhanced Knowledge Graph).
Code Example:
Copy curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer xxxxxxxxxxxxxxxx" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&ibp=new\"}" tbs (Optional)
Advanced filters:
Time: qdr:h (1 hour), qdr:y (1 year)
Content: sur:f (images), sur:fc (free-to-use images)
Code Example:
Copy curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer xxxxxxxxxxxxxxxx" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&tbs=sur:f\"}" nfpr (Optional)
Disables autocorrect (e.g., nfpr=1 prevents "googl" → "google").
Code Example:
Copy curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer xxxxxxxxxxxxxxxx" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&nfpr=1\"}" filter (Optional)
Deduplicates results: 1 (enable), 0 (disable).
Code Example:
Copy curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer xxxxxxxxxxxxxxxx" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&filter=1\"}" 