Skip to content
Examples

Get Geolocation

Fetch valid regions, districts, and cities for parameter-based tasks

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/googlemaps/locations

Use this endpoint to fetch valid regions, districts, and cities used in parameter-based tasks for the Google Maps Search Export crawler. This is essential when constructing structured tasks where accurate location inputs are required.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

country_codestringqueryrequired

ISO 2-letter country code. Example: US

regionstringquery

State or province name. Example: California

districtstringquery

County or local district. Example: San Diego

citystringquery

City name filter

How It Works

The value you leave empty determines what the API returns:

  • Leave region empty to get regions for a country
  • Provide region, leave city empty to get cities in that region
  • Provide district to narrow down the city list further

Query Parameters

Parameter Required Description
country_code Yes ISO 2-letter country code (e.g., US, FR, PK)
region Conditional Required when querying districts or cities. Leave empty to get regions.
district No Narrows the city list within a region
city No Used when retrieving a refined list of locations

Use the returned values for region, district, and city in parameter-based tasks.

The city list has one entry per point on the map. Several postal codes of the same town often share its coordinates (for example Aix-en-Provence 13080, 13090, 13100 and its business-only CEDEX codes): only one of them is returned, because every task searches around the city's coordinates and keeps results within 10 km of them. Cities with their own coordinates, even close to each other, are all returned.

Combine location values with category to generate accurate search inputs.

Code Examples

curl -X GET "https://api.lobstr.io/v1/googlemaps/locations?country_code=US&region=California&city" \
  -H "Authorization: Token YOUR_API_KEY"

Response

200
[
  "Acampo 95220",
  "Acton 93510",
  "Adelanto 92301",
  "Adin 96006",
  "Agoura Hills 91301",
  "Agoura Hills 91376",
  "Aguanga 92536",
  "Ahwahnee 93601",
  "Alameda 94501",
  "Alameda 94502",
  "Alamo 94507",
  "Albany 94706",
  "Albion 95410",
  "Alderpoint 95511",
  "Alhambra 91801",
  "Alhambra 91802",
  "Alhambra 91803"
]