Piloterr

Google Maps

GET
/v2/google/maps

Extract comprehensive company data from Google Maps for enhanced business insights.

Credit cost: 3 credits per call

Authorization

ApiKeyAuth
headerx-api-key<token>

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

Query Parameters

query*string

Business name or keyword to search for relevant data.

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
status?string
results?array<>
Example Request
curl -X GET 'https://api.piloterr.com/v2/google/maps?query=string'
Example Response
{  "status": "OK",  "results": [    {      "name": "Restaurant Example 1",      "rating": 4.5,      "address": "123 Sample Street, Toulouse",      "website": "http://www.restaurantexample1.com",      "coordinates": {        "lat": 43.6,        "lng": 1.45      },      "phone_number": "+33 1 23 45 67 89",      "user_reviews": [        {          "user": "John Doe",          "rating": 5,          "comment": "Amazing food and ambiance."        },        {          "user": "Jane Smith",          "rating": 4,          "comment": "Good service, but a bit pricey."        }      ]    },    {      "name": "Restaurant Example 2",      "rating": 4,      "address": "456 Demo Avenue, Toulouse",      "website": "http://www.restaurantexample2.com",      "coordinates": {        "lat": 43.605,        "lng": 1.455      },      "phone_number": "+33 1 98 76 54 32",      "user_reviews": [        {          "user": "Alice Brown",          "rating": 5,          "comment": "Fantastic vegetarian options!"        },        {          "user": "Bob White",          "rating": 3.5,          "comment": "Nice place, but the food took a while to arrive."        }      ]    },    {      "name": "Restaurant Example 3",      "rating": 3.8,      "address": "789 Example Boulevard, Toulouse",      "website": "http://www.restaurantexample3.com",      "coordinates": {        "lat": 43.61,        "lng": 1.46      },      "phone_number": "+33 1 11 22 33 44",      "user_reviews": [        {          "user": "Charlie Black",          "rating": 4,          "comment": "Unique dishes and friendly staff."        },        {          "user": "Dana Green",          "rating": 3.5,          "comment": "Could improve on cleanliness."        }      ]    }  ]}