Autom

Google Locations

GET
/v1/finder/google-locations

Find supported Google locations and retrieve location IDs and country codes (free endpoint).

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

Search locations supported by Piloterr (cities, countries, etc.) by providing a query string. Returns matching locations ordered by reach.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
[index: integer]?
Example Request
curl -X GET 'https://api.autom.dev/v1/finder/google-locations?query=string'
Example Response
[  {    "id": "585069b8ee19ad271e9ba949",    "gps": [      -97.7430608,      30.267153    ],    "name": "Austin",    "reach": 6440000,    "google_id": 1026201,    "target_type": "City",    "country_code": "US",    "canonical_name": "Austin,Texas,United States"  }]