GET
/
api
/
v2
/
finder
/
google-locations
Google Locations
curl --request GET \
  --url https://piloterr.com/api/v2/finder/google-locations \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "<string>"
}'
[
    {
        "id": "585069a2ee19ad271e9b5052",
        "google_id": 1001982,
        "google_parent_id": 20115,
        "name": "Austin",
        "canonical_name": "Austin,Manitoba,Canada",
        "country_code": "CA",
        "target_type": "City",
        "reach": 0,
        "gps": [-98.936927, 49.951529]
    }
]
Locations API allows you to search Piloterr supported locations. It should return an array of locations ordered by reach. Locations that reach the most people will be first. This API is free to use.

​
Search Query

​
query
string
required
Parameter restricts your search to locations that contain the supplied string. (e.g., Austin will find ‘Austin, TX’, ‘The University of Texas at Austin’, ‘Rochester, MN-Mason City, IA-Austin, MN,United States’, etc.)

​
Response

​
id
string
Unique location identifier
​
google_id
number
Google location identifier
​
google_parent_id
number
Google parent identifier
​
name
string
Location name
​
canonical_name
string
Full canonical name including city, state/province, and country
​
country_code
string
Two-letter country code
​
target_type
string
Location type (City, Country, etc.)
​
reach
number
Population reach of the location
​
gps
array
GPS coordinates [longitude, latitude]
[
    {
        "id": "585069a2ee19ad271e9b5052",
        "google_id": 1001982,
        "google_parent_id": 20115,
        "name": "Austin",
        "canonical_name": "Austin,Manitoba,Canada",
        "country_code": "CA",
        "target_type": "City",
        "reach": 0,
        "gps": [-98.936927, 49.951529]
    }
]