Google Maps

SERP API Google Query Parameters

Configure Google search queries using Thordata’s SERP API, including localization parameters, geotargeting,search type,pagination 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_maps" \
 -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_maps" \
 -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_maps" \
 -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_maps" \
 -d "q=pizza" \
 -d "json=1" \
 -d "hl=es"

Geographical Location

ll ,GPS Coordinates(Optional)

The GPS parameter defines the coordinates of the location you wish the search to originate from. Its value must match the following format:

@ + latitude + , + longitude + , + scale

@40.7455096,-74.0083012,14z

Example Request:

Example results for q : pizza,ll: @40.7455096,-74.0083012,14z

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_maps" \
 -d "q=pizza" \
 -d "json=1" \
 -d "[email protected],-74.0083012,14z"

Search Types

type ,Type of search(Optional)

The search parameter defines the type of search to be performed. It can be set to:

search - returns a list of results when the q parameter is set,

place - returns results for a specific location when the data parameter is set

No parameter is required when using place_id or data_cid.

Example Request:

Example results for q : pizza,type:search

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

Pagination

start ,Result offset(Optional)

Set the starting point for search result pagination (e.g., "start=30" means skipping the first 30 results and starting to display from the 31st result).

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

Advanced Parameters

data ,Data(Optional)

Parameters can be used to filter search results. You can visit the Google Maps website, set up the filters you want, and then simply copy the data values from its URL to SerpApi URL.

Example Request:

Example results for q : pizza,data:20250815

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

place_id ,Place ID(Optional)

A parameter defines a unique reference to a place in Google Maps. Place ID works for most places, including businesses, landmarks, parks, and intersections. You can find place_id using our Google Maps API.

Example Request:

Example results for q : pizza,place_id:541541233999

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

data_cid ,Google CID(Optional)

A parameter defines the Google CID (customer identifier) of a place. This parameter can be found in Google Maps API local results, as well as in Google Search API and Google Local API local results, and is named place_id. You can also use Google's CID converter to get it.

Code Example:

Example results for q : pizza,data_cid:001

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

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