Skip to main content

​
Google Maps Extractor

Search and extract business listings from Google Maps with filters for ratings, websites, and categories. 1 credit/row

​
Parameters

ParameterTypeRequiredDescription
searchStringsArrayarrayYesArray of search terms. E.g., ["restaurants in NYC", "dentists in London"]
locationQuerystringYesLocation context. Format: "City, Country". E.g., "New York, United States"
maxCrawledPlacesPerSearchintegerYesMaximum places per search term. Default: 100
placeMinimumStarsstringNoMinimum star rating filter: two, twoAndHalf, three, threeAndHalf, four, fourAndHalf
websitestringNoWebsite filter: allPlaces, withWebsite, or withoutWebsite
categoryFilterOutsidearrayNoExclude places matching these categories (lowercase). E.g., ["gas station", "atm"]

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/google-maps/extractor/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "searchStringsArray": ["coffee shops"],
      "locationQuery": "San Francisco, United States",
      "maxCrawledPlacesPerSearch": 50,
      "placeMinimumStars": "four",
      "website": "withWebsite"
    }
  }'

​
Google Maps Reviews Scraper

Extract reviews from specific Google Maps places including ratings, text, and reviewer info. 1 credit/row

​
Parameters

ParameterTypeRequiredDescription
startUrlsarrayYesArray of URL objects pointing to Google Maps place pages. E.g., [{"url": "https://www.google.com/maps/place/..."}]
maxReviewsintegerYesMaximum number of reviews per place. Default: 100
reviewsSortstringNoSort order for reviews. Default: newest

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/google-maps/reviews-scraper/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "startUrls": [{"url": "https://www.google.com/maps/place/Starbucks/@40.7128,-74.006"}],
      "maxReviews": 100,
      "reviewsSort": "newest"
    }
  }'

​
Reverse Geocoding

Convert geographic coordinates into human-readable addresses using Google Maps. 1 credit/row

​
Parameters

ParameterTypeRequiredDescription
coordinatesarrayYesArray of coordinate strings in "latitude,longitude" format. E.g., ["40.7128,-74.0060", "34.0522,-118.2437"]

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/google-maps/reverse-geocoding/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "coordinates": ["40.7128,-74.0060", "34.0522,-118.2437"]
    }
  }'