Google Local

SERP API Google Query Parameters

Configure Google local queries using Thordata’s SERP API, including localization parameters, geotargeting, pagination,,Advanced Filters,and "advanced parameter" output options.

q ,Search Query(Required)

Define the search query used for data scraping (Default value: q=pizza). Any keywords in any language are supported.

Example Request: Example using the parameter q: pizza

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_local" \
 -d "q=pizza" \
 -d "json=1"

Localization

google_domain,Domain(Optional)

Define the search engine domain name for data crawling (default value: google.com).

You can modify this parameter in the system or refer to the Google domain page to obtain the complete list of supported domain names.

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_local" \
 -d "q=pizza" \
 -d "google_domain=google.co.ao" \
 -d "json=1"

gl ,Country(Optional)

Specify the target country/region for search results (default value: us). Use two-letter country codes(e.g., us, ru, uk).

For the complete list of supported country codes, please refer to: 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_local" \
 -d "q=pizza" \
 -d "gl=ru" \
 -d "json=1"

hl ,Language(Optional)

Set the interface language for search results (default value: en). Adopt standard language code formats (e.g., en, es, zh-CN).

For the complete list of supported language codes, please refer to: 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_local" \
 -d "q=pizza" \
 -d "json=1" \
 -d "hl=es"

Geographical Location

location ,Location(Optional)

Simulate initiating a search from an exact location, which must be used in conjunction with the uule parameter. If not specified, the geographical location of the proxy server may be adopted.

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_local" \
 -d "q=pizza" \
 -d "json=1" \
 -d "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"

uule ,Encoded Location(Optional)

Encode the target geographical location using Base64, which must be used in conjunction with the location parameter.

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_local" \
 -d "q=pizza" \
 -d "json=1" \
 -d "location=India" \
 -d "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. On desktop, parameter only accepts multiples of 20 (e.g. 20 for the second page results, 40 for the third page results, etc.). On mobile, parameter only accepts multiples of 10 (e.g. 10 for the second page results, 20 for the third page results, etc.).

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_local" \
 -d "q=pizza" \
 -d "json=1" \
 -d "start=30"

Advanced Parameters

ludocid ,Google Place ID(Optional)

This parameter defines the identifier (CID) of the Google My Business listing you want to crawl. It is also known as the Google Place ID. (e.g., ludocid=14389889685039125943).

Example Request:

Example results for q : pizza,ludocid:14389889685039125943

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_local" \
 -d "q=pizza" \
 -d "json=1" \
 -d "ludocid=14389889685039125943"

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_local" \
 -d "q=pizza" \
 -d "json=1" \
 -d "tbs=sur:f"

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