Skip to main content
GET
/
v1
/
googlelocations
Get Geolocation
curl --request GET \
  --url https://api.lobstr.io/v1/googlelocations \
  --header 'Authorization: <authorization>'
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

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY

​
Query Parameters

​
q
string
required
Search substring for location names. Example: Alabama
​
country_name
string
required
Full country name. Example: United States

​
Query Parameters

ParameterRequiredDescription
qYesSubstring to search for in region, district, or city names
country_nameYesFull country name to scope the search (e.g., United States)

​
Response Fields

FieldTypeDescription
namestringDisplay name of the location (region, district, or city)
canonical_namestringFull hierarchical name (e.g., Alabama,United States)
country_namestringCountry associated with this location
country_codestringISO 2-letter country code (e.g., US)
Use the returned name value as your params.location setting.
Location values provide geographic bias - search results will be relevant to that area.

​
Code Examples

curl -X GET "https://api.lobstr.io/v1/googlelocations?q=Alabama&country_name=United%20States" \
  -H "Authorization: Token YOUR_API_KEY"

​
Response

200
{
  "success": true,
  "data": [
    {
      "name": "Alabama",
      "canonical_name": "Alabama,United States",
      "country_name": "United States",
      "country_code": "US"
    },
    {
      "name": "Alabama's 1st Congressional District 2022 redistricting",
      "canonical_name": "Alabama's 1st Congressional District 2022 redistricting,Alabama,United States",
      "country_name": "United States",
      "country_code": "US"
    },
    {
      "name": "The University of Alabama",
      "canonical_name": "The University of Alabama,Alabama,United States",
      "country_name": "United States",
      "country_code": "US"
    },
    {
      "name": "University of Alabama at Birmingham",
      "canonical_name": "University of Alabama at Birmingham,Alabama,United States",
      "country_name": "United States",
      "country_code": "US"
    }
  ]
}