> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<ParamField header="Authorization" type="string" required>
  Your API authentication token. Value: `Token YOUR_API_KEY`
</ParamField>

## Query Parameters

<ParamField query="q" type="string" required>
  Search substring for location names. Example: `Alabama`
</ParamField>

<ParamField query="country_name" type="string" required>
  Full country name. Example: `United States`
</ParamField>

## Query Parameters

| Parameter         | Required | Description                                                   |
| ----------------- | -------- | ------------------------------------------------------------- |
| **q**             | Yes      | Substring to search for in region, district, or city names    |
| **country\_name** | Yes      | Full country name to scope the search (e.g., `United States`) |

## Response Fields

| Field               | Type   | Description                                              |
| ------------------- | ------ | -------------------------------------------------------- |
| **name**            | string | Display name of the location (region, district, or city) |
| **canonical\_name** | string | Full hierarchical name (e.g., `Alabama,United States`)   |
| **country\_name**   | string | Country associated with this location                    |
| **country\_code**   | string | ISO 2-letter country code (e.g., `US`)                   |

<Tip>
  Use the returned `name` value as your `params.location` setting.
</Tip>

<Note>
  Location values provide geographic bias - search results will be relevant to that area.
</Note>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.lobstr.io/v1/googlelocations?q=Alabama&country_name=United%20States" \
    -H "Authorization: Token YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  API_KEY = "YOUR_API_KEY"
  BASE_URL = "https://api.lobstr.io/v1"
  headers = {"Authorization": f"Token {API_KEY}"}

  # Search for locations containing "Alabama" in United States
  response = requests.get(f"{BASE_URL}/googlelocations",
      headers=headers,
      params={
          "q": "Alabama",
          "country_name": "United States"
      }
  )

  data = response.json()
  print(f"Found {len(data['data'])} locations")
  for location in data["data"][:5]:
      print(f"  {location['name']} ({location['country_code']})")
  ```
</CodeGroup>

## Response

```json 200 theme={null}
{
  "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"
    }
  ]
}
```