Autom

Google Maps

GET
/v1/google/maps

Search Google Maps via API and retrieve structured place results (address, website, phone).

Credit cost: 1 credit per call

Autorización

ApiKeyAuth
headerx-api-key<token>

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

Parámetros de consulta

query*string

Search query for Google Maps (e.g. business type, brand, or place name).

page?number

Page number for pagination (1 = first page).

Default"1"
google_domain?string

Google domain to use for the search. Defaults to google.com.

Examples:

  • google.com
  • google.co.uk
  • google.fr

Example:

google.com
Default"google.com"
gl?string

Country to use for the Google search. Two-letter country code (e.g. us for the United States, uk for United Kingdom, or fr for France).

Example:

us
hl?string

Language to use for the Google search. Two or three-letter language code (e.g. en, es, fr), optionally followed by a region code (e.g. en-gb, es-419).

Example:

en
cr?string

Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE).

Example:

countryUS
lr?string

Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de).

Example:

lang_en
ll?string

Map center / geo hint in Google format (e.g. @43.5131985,1.4600501,60m). Helps focus results around a coordinate and zoom radius.

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

Cuerpo de la respuesta

Successful response

application/json
  1. response
[index: integer]?
Example Request
curl -X GET 'https://api.autom.dev/v1/google/maps?query=string'
Example Response
[  {    "fid": "0x12aebf2675445053:0xff6b4af3e0c18407",    "lat": null,    "long": null,    "title": null,    "address": "Le 153 Bar & Cocktails, 153 Rue Saint-Martin, 75003 Paris",    "website": "https://www.le153.com/",    "phone_number": "+33 7 62 82 29 26"  }]