> ## Documentation Index
> Fetch the complete documentation index at: https://mindcase.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Maps Places

> Search Google Maps places for address, rating, reviews, contact info, opening hours, and images

`$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

<ParamField body="keywords" type="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.
</ParamField>

<ParamField body="location" type="string">
  **Text** · Where to search (e.g. 'New York, USA'). Required when Search Terms is used; ignored when passing Place URLs.
</ParamField>

<ParamField body="urls" type="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.
</ParamField>

<ParamField body="maxResults" type="integer" default={50}>
  **Number** · Maximum number of places to return per search term or URL. Use 0 for all.
</ParamField>

<ParamField body="minimumRating" type="string">
  **Dropdown** · Skip places rated below this. Leave empty for no filter.

  **Options:** `two`, `twoAndHalf`, `three`, `threeAndHalf`, `four`, `fourAndHalf`

  *Legend: `two` = 2+ stars, `twoAndHalf` = 2.5+ stars, `three` = 3+ stars, `threeAndHalf` = 3.5+ stars, `four` = 4+ stars, `fourAndHalf` = 4.5+ stars*
</ParamField>

<ParamField body="websiteFilter" type="string" default="allPlaces">
  **Dropdown** · Filter by website presence. Useful for lead generation (find places without a website).

  **Options:** `allPlaces`, `withWebsite`, `withoutWebsite`

  *Legend: `allPlaces` = All places, `withWebsite` = Only with website, `withoutWebsite` = Only without website*
</ParamField>

<ParamField body="maxImages" type="integer" default={0}>
  **Number** · Number of images to fetch per place. 0 = none, 999 = all. Slows down the run.
</ParamField>

## 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

<CodeGroup>
  ```bash curl theme={null}
  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
    }
  }'
  ```

  ```python Python theme={null}
  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()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "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"
        }
      ]
    }
  ]
}
```