POST /v1/data/google-maps/places/run
Pricing: $0.004 per place ($4.00 per 1,000). Setting maxImages above 0 adds $0.00025 per delivered image.
Two ways to find places: pass Search Terms + Location to discover, or pass Place URLs / IDs to look up specific ones. Pick whichever fits; the rest below are optional filters.
Ways to call it
- Search: set
keywords,location(optional:maxResults,minimumRating,websiteFilter) - Place ID/URL: set
urls
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
What to search for (e.g. ‘italian restaurants’). Use this together with Location to discover places. OR leave blank and pass specific URLs in the Place URLs field below.Use together with
location.Where to search (e.g. ‘New York, USA’). One location per run. To search several, run them one at a time. Required for keyword search.Use together with
keywords.Specific Google Maps place URLs or Place IDs (e.g. ChIJreV9aqYWdkgROM_boL6YbwA). Use this when you already know the places, as an alternative to Search Terms + Location.
Skip places rated below this. Leave empty for no filter.Allowed values:
two (2+ stars), twoAndHalf (2.5+ stars), three (3+ stars), threeAndHalf (3.5+ stars), four (4+ stars), fourAndHalf (4.5+ stars).Filter by website presence. Useful for lead generation (find places without a website).Allowed values:
allPlaces (All places), withWebsite (Only with website), withoutWebsite (Only without website).Number of images to fetch per place. 0 = none, 999 = all. More images cost more and slow the run.
Example
Response fields
Each row indata is one place, keyed by these fields.
Example response
Abridged: long text and lists are shortened.Related APIs
For a place’s review text usegoogle-maps/reviews.