GET/v1/googlelocations

Get Geolocation

Fetch valid location values for geographic search bias

Use this endpoint to fetch valid location values for the params.location setting in the Google Search Scraper. These values provide geographic bias for your search queries.

Headers

KeyValueRequired
AuthorizationToken YOUR_API_KEYYes

Query Parameters

q
Required:
Yes
Description:
Substring to search for in region, district, or city names
country_name
Required:
Yes
Description:
Full country name to scope the search (e.g., `United States`)

Response Fields

name
Type:
string
Description:
Display name of the location (region, district, or city)
canonical_name
Type:
string
Description:
Full hierarchical name (e.g., `Alabama,United States`)
country_name
Type:
string
Description:
Country associated with this location
country_code
Type:
string
Description:
ISO 2-letter country code (e.g., `US`)

Parameters

qstring
Required
Search substring for location names
Example: Alabama
country_namestring
Required
Full country name
Example: United States
Pro Tip

Pro Tip

Use the returned `name` value as your `params.location` setting.
Note

Note

Location values provide geographic bias - search results will be relevant to that area.