# Google Locations Finder

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/finder/google-locations` |
| **Base URL** | `https://api.autom.dev` |
| **Credit Cost** | 0 credits per call |
| **Documentation** | https://www.piloterr.com/library/finder-google-locations |

## Description

Search Google-supported locations by name to retrieve location IDs and GPS coordinates for geo-targeted search API calls.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.autom.dev/register

## Example Request

```bash
curl --location --request GET 'https://api.autom.dev/v2/finder/google-locations' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search by location 'Austin'

```json
[
  {
    "id": "585069a2ee19ad271e9b5052",
    "gps": [
      -98.936927,
      49.951529
    ],
    "name": "Austin",
    "reach": 0,
    "google_id": 1001982,
    "target_type": "City",
    "country_code": "CA",
    "canonical_name": "Austin,Manitoba,Canada",
    "google_parent_id": 20115
  }
]
```

## Documentation

## Overview
The Google Locations Finder endpoint allows you to search for Piloterr-supported locations including cities, regions, and countries. Results are ordered by reach: locations with the widest population coverage appear first. This endpoint is free to use and is designed to resolve location names into Google location identifiers for use in geo-targeted search API calls.

## Quickstart
```
GET https://api.piloterr.com/v2/finder/google-locations?query=paris
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | String to search for in location names |

## Response fields
| Field | Type | Description |
|---|---|---|
| `id` | string | Unique Piloterr location identifier |
| `google_id` | number | Google location identifier |
| `google_parent_id` | number | Google parent location identifier |
| `name` | string | Location name |
| `canonical_name` | string | Full canonical name (city, state/province, country) |
| `country_code` | string | Two-letter ISO country code |
| `target_type` | string | Location type (City, Country, Region, etc.) |
| `reach` | number | Population reach of the location |
| `gps` | array | GPS coordinates [longitude, latitude] |

## Notes
- Results are ordered by population reach
- A search for 'Austin' may return multiple matches: Austin TX, Austin MN, Austin Manitoba, etc.
- Use `google_id` as the location parameter in Google Search API calls

## Main use cases
- Resolve city or region names to Google location IDs for geo-targeted SERP scraping
- Build location pickers for local SEO and rank tracking tools
- Identify GPS coordinates of target markets for spatial data enrichment
- Enumerate all available Google locations to validate user input in search automation workflows