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
x-api-key<token>

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

In: header

Query Parameters

query*string

Business name or keyword to search for relevant data.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/google/maps?query=string"
{  "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."        }      ]    }  ]}
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}