Google Maps
GET
Extract comprehensive company data from Google Maps for enhanced business insights.
Credit cost: 3 credits per call
ApiKeyAuthheader
x-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringBusiness name or keyword to search for relevant data.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
Default
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
Default
falseSuccessful response
application/json- response
status?stringresults?array<>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." } ] } ]}