Skip to main content
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 under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
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.
string
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.
string[]
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.
integer
Number of places to return. Use 0 for all.
string
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).
string
default:"allPlaces"
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).
integer
default:"0"
Number of images to fetch per place. 0 = none, 999 = all. More images cost more and slow the run.

Example

Response fields

Each row in data is one place, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For a place’s review text use google-maps/reviews.