Google Maps Places

$2 / 1k places Search Google Maps places for address, rating, reviews, contact info, opening hours, and images

Endpoint

POST /api/v1/agents/google/maps/places/run

Parameters

array

List · 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.

string

Text · Where to search (e.g. ‘New York, USA’). Required when Search Terms is used; ignored when passing Place URLs.

array

List · Specific Google Maps place URLs or Place IDs (e.g. ChIJreV9aqYWdkgROM_boL6YbwA). Use this when you already know the places — alternative to Search Terms + Location.

integer

default:50

Number · Maximum number of places to return per search term or URL. Use 0 for all.

string

Dropdown · Skip places rated below this. Leave empty for no filter.Options: two, twoAndHalf, three, threeAndHalf, four, fourAndHalfLegend: two = 2+ stars, twoAndHalf = 2.5+ stars, three = 3+ stars, threeAndHalf = 3.5+ stars, four = 4+ stars, fourAndHalf = 4.5+ stars

string

default:"allPlaces"

Dropdown · Filter by website presence. Useful for lead generation (find places without a website).Options: allPlaces, withWebsite, withoutWebsiteLegend: allPlaces = All places, withWebsite = Only with website, withoutWebsite = Only without website

integer

default:0

Number · Number of images to fetch per place. 0 = none, 999 = all. Slows down the run.

Response columns

Field	Display name	Type
`searchQuery`	Search Query	text
`location`	Location	text
`placeUrl`	Place URL	url
`businessName`	Business Name	text
`category`	Category	text
`allCategories`	All Categories	text
`rating`	Rating	rating
`reviews`	Reviews	number
`priceRange`	Price Range	text
`address`	Address	text
`phone`	Phone	phone
`website`	Website	url
`description`	Description	text
`photo`	Photo	url
`photoCount`	Photo Count	number
`neighborhood`	Neighborhood	text
`city`	City	text
`state`	State	text
`postalCode`	Postal Code	text
`country`	Country	text
`street`	Street	text
`latitude`	Latitude	number
`longitude`	Longitude	number
`permanentlyClosed`	Permanently Closed	boolean
`temporarilyClosed`	Temporarily Closed	boolean
`unclaimed`	Unclaimed	boolean
`topTag`	Top Tag	text
`topTagCount`	Top Tag Count	number
`5StarReviews`	5-Star Reviews	number
`4StarReviews`	4-Star Reviews	number
`3StarReviews`	3-Star Reviews	number
`2StarReviews`	2-Star Reviews	number
`1StarReviews`	1-Star Reviews	number
`placeId`	Place ID	text
`additionalInfo`	Additional Info	object
`openingHours`	Opening Hours	object

Example

curl -X POST https://api.mindcase.co/api/v1/agents/google/maps/places/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "keywords": [
      "restaurants"
    ],
    "location": "New York, USA",
    "maxResults": 10
  }
}'

import requests

resp = requests.post(
    "https://api.mindcase.co/api/v1/agents/google/maps/places/run",
    headers={"Authorization": "Bearer mk_live_abc123def456"},
    json={"params": {
    "keywords": [
        "restaurants"
    ],
    "location": "New York, USA",
    "maxResults": 10
}},
)
data = resp.json()

Example response

Response

{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "searchQuery": "restaurants",
      "location": "New York, USA",
      "placeUrl": "https://www.google.com/maps/search/?api=1&query=Loukoumi%20Taverna&query_place_id=ChIJ11iMTW5fwokRYr9z-BtZDr0",
      "businessName": "Loukoumi Taverna",
      "category": "Greek restaurant",
      "allCategories": [
        "Greek restaurant",
        "Family restaurant",
        "Mediterranean restaurant",
        "Seafood restaurant"
      ],
      "rating": 4.7,
      "reviews": 1447,
      "priceRange": "$30\u201380",
      "address": "45-07 Ditmars Blvd, Astoria, NY 11105",
      "phone": "(718) 626-3200",
      "website": "https://toloukoumi.com/",
      "description": "Cozy destination with exposed stone walls & wood beams offering takes on classic Greek cuisine.",
      "photo": "https://lh3.googleusercontent.com/gps-cs-s/APNQkAGQMNnxDBl9V58kZBB9ncSiEVCAtM6did-2_MCK1OQdub90jnUj9z1ryIKVYNE-TPzoj7WdJjGvUxtcRNyRI_jKomIt68KFUCJ-7K9Qs32-8m-P7al-MqtCRJ1NwBtVSzx8qt1rv2K2mdVH=w408-h272-k-no",
      "photoCount": 969,
      "neighborhood": "Astoria",
      "city": "Astoria",
      "state": "New York",
      "postalCode": "11105",
      "country": "US",
      "street": "45-07 Ditmars Blvd",
      "latitude": 40.7707829,
      "longitude": -73.9027712,
      "permanentlyClosed": false,
      "temporarilyClosed": false,
      "unclaimed": false,
      "topTag": null,
      "topTagCount": null,
      "5StarReviews": 1204,
      "4StarReviews": 159,
      "3StarReviews": 49,
      "2StarReviews": 14,
      "1StarReviews": 21,
      "placeId": "ChIJ11iMTW5fwokRYr9z-BtZDr0",
      "additionalInfo": {
        "Service options": [
          {
            "Outdoor seating": true
          },
          {
            "No-contact delivery": true
          },
          {
            "Delivery": true
          },
          {
            "Takeout": true
          },
          {
            "Dine-in": true
          },
          {
            "Onsite services": false
          }
        ],
        "Highlights": [
          {
            "Fast service": true
          },
          {
            "Great cocktails": true
          },
          {
            "Great coffee": true
          },
          {
            "Great wine list": true
          },
          {
            "Serves local specialty": true
          }
        ],
        "Popular for": [
          {
            "Lunch": true
          },
          {
            "Dinner": true
          },
          {
            "Solo dining": true
          }
        ],
        "Accessibility": [
          {
            "Wheelchair accessible entrance": true
          },
          {
            "Wheelchair accessible restroom": true
          },
          {
            "Wheelchair accessible seating": true
          },
          {
            "Assistive hearing loop": false
          },
          {
            "Wheelchair accessible parking lot": false
          }
        ],
        "Offerings": [
          {
            "Alcohol": true
          },
          {
            "Beer": true
          },
          {
            "Cocktails": true
          },
          {
            "Coffee": true
          },
          {
            "Comfort food": true
          },
          {
            "Hard liquor": true
          },
          {
            "Healthy options": true
          },
          {
            "Late-night food": true
          },
          {
            "Small plates": true
          },
          {
            "Vegetarian options": true
          },
          {
            "Wine": true
          }
        ],
        "Dining options": [
          {
            "Lunch": true
          },
          {
            "Dinner": true
          },
          {
            "Dessert": true
          },
          {
            "Seating": true
          },
          {
            "Table service": true
          }
        ],
        "Amenities": [
          {
            "Bar onsite": true
          },
          {
            "Restroom": true
          },
          {
            "Wi-Fi": true
          },
          {
            "Free Wi-Fi": true
          }
        ],
        "Atmosphere": [
          {
            "Casual": true
          },
          {
            "Cozy": true
          },
          {
            "Quiet": true
          },
          {
            "Romantic": true
          }
        ],
        "Crowd": [
          {
            "Family-friendly": true
          },
          {
            "Groups": true
          },
          {
            "LGBTQ+ friendly": true
          },
          {
            "Tourists": true
          },
          {
            "Transgender safespace": true
          }
        ],
        "Planning": [
          {
            "Dinner reservations recommended": true
          },
          {
            "Accepts reservations": true
          }
        ],
        "Payments": [
          {
            "Credit cards": true
          },
          {
            "Debit cards": true
          },
          {
            "NFC mobile payments": true
          },
          {
            "Credit cards": true
          }
        ],
        "Children": [
          {
            "Good for kids": true
          },
          {
            "High chairs": true
          }
        ],
        "Parking": [
          {
            "Free street parking": true
          },
          {
            "Paid street parking": true
          },
          {
            "Usually plenty of parking": true
          }
        ]
      },
      "openingHours": [
        {
          "day": "Monday",
          "hours": "12 to 10\u202fPM"
        },
        {
          "day": "Tuesday",
          "hours": "12 to 10\u202fPM"
        },
        {
          "day": "Wednesday",
          "hours": "12 to 10\u202fPM"
        },
        {
          "day": "Thursday",
          "hours": "12 to 10\u202fPM"
        },
        {
          "day": "Friday",
          "hours": "12 to 11\u202fPM"
        },
        {
          "day": "Saturday",
          "hours": "12 to 11\u202fPM"
        },
        {
          "day": "Sunday",
          "hours": "12 to 10\u202fPM"
        }
      ]
    }
  ]
}

Agents

Jobs

Endpoint

Parameters

Response columns

Example

Example response

​Endpoint

​Parameters

​Response columns

​Example

​Example response

Endpoint

Parameters

Response columns

Example

Example response