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

# Google Maps Places API

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

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

**keywords** `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`.

**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`.

**urls** `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.

**maxResults** `integer`

Number of places to return. Use 0 for all.

**minimumRating** `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).

**websiteFilter** `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).

**maxImages** `integer` (default: 0)

Number of images to fetch per place. 0 = none, 999 = all. More images cost more and slow the run.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/google-maps/places/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "keywords": "dental clinic",
    "location": "Austin, Texas",
    "maxResults": 10
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/google-maps/places/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "keywords": "dental clinic",
    "location": "Austin, Texas",
    "maxResults": 10
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/google-maps/places/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "keywords": "dental clinic",
  "location": "Austin, Texas",
  "maxResults": 10
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

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

| Field | Name | Type |
| - | - | - |
| `placeUrl` | Place URL | url |
| `businessName` | Business Name | text |
| `placeId` | Place ID | text |
| `category` | Category | text |
| `allCategories` | All Categories | array |
| `categoryId` | Category ID | text |
| `placeTags` | Place Tags | array |
| `rating` | Rating | rating |
| `reviews` | Reviews | number |
| `reviewBreakdown` | Review Breakdown | object |
| `reviewKeywords` | Review Keywords | object\_array |
| `reviewsUrl` | Reviews URL | url |
| `priceRange` | Price Range | text |
| `phone` | Phone | phone |
| `website` | Website | url |
| `emails` | Emails | array |
| `additionalPhones` | Additional Phones | array |
| `socials` | Socials | object |
| `directoryProfiles` | Directory Profiles | object |
| `address` | Address | text |
| `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 |
| `entranceLocation` | Entrance Location | object |
| `plusCode` | Plus Code | text |
| `locatedIn` | Located In | text |
| `floor` | Floor | text |
| `permanentlyClosed` | Permanently Closed | boolean |
| `temporarilyClosed` | Temporarily Closed | boolean |
| `unclaimed` | Unclaimed | boolean |
| `owner` | Owner | object |
| `description` | Description | text |
| `attributes` | Attributes | object |
| `openingHours` | Opening Hours | object |
| `specialHours` | Special Hours | array |
| `popularTimes` | Popular Times | object |
| `liveOccupancyPercent` | Live Occupancy Percent | number |
| `liveStatus` | Live Status | text |
| `coverPhoto` | Cover Photo | url |
| `photos` | Photos | array |
| `photoCount` | Photo Count | number |
| `relatedPlaces` | Related Places | object\_array |
| `ownerPosts` | Owner Posts | object\_array |
| `menuUrl` | Menu URL | url |
| `reserveTableUrl` | Reserve Table URL | url |
| `reservationLinks` | Reservation Links | object\_array |
| `hotelType` | Hotel Type | text |
| `hotelDescription` | Hotel Description | text |
| `similarHotels` | Similar Hotels | object\_array |
| `hotelAds` | Hotel Ads | object\_array |
| `formattedPhone` | Formatted Phone | phone |
| `subTitle` | Sub Title | text |
| `placesTags` | Places Tags | array |
| `imageCategories` | Image Categories | array |
| `updatesFromCustomers` | Updates From Customers | array |
| `restaurantData` | Restaurant Data | object |
| `checkInDate` | Check In Date | text |
| `checkOutDate` | Check Out Date | text |
| `openingHoursBusinessConfirmationText` | Opening Hours Business Confirmation Text | text |
| `searchPageUrl` | Search Page URL | text |
| `scrapedAt` | Scraped At | text |
| `rank` | Rank | text |
| `cid` | Cid | text |
| `fid` | Fid | text |
| `kgmid` | Kgmid | text |
| `isAdvertisement` | Is Advertisement | boolean |
| `language` | Language | text |
| `gasPrices` | Gas Prices | array |
| `leadsEnrichment` | Leads Enrichment | object |
| `questionsAndAnswers` | Questions And Answers | array |
| `reviewsList` | Reviews List | array |
| `webResults` | Web Results | array |
| `googleFoodUrl` | Google Food URL | text |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "google-maps/places",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "menuUrl": null,
      "hotelType": null,
      "locatedIn": "AMLI South Shore",
      "longitude": -97.73065969999999,
      "additionalPhones": null,
      "reviewBreakdown": {
        "five": 587,
        "four": 18,
        "three": 10,
        "two": 11,
        "one": 56
      },
      "emails": [
        "riverside@aloha-dental.com"
      ],
      "liveStatus": null,
      "priceRange": null,
      "floor": null,
      "placeTags": [
        "LGBTQ+ friendly"
      ],
      "placeId": "ChIJMbq0xFG0RIYRh21ETz1YA1E",
      "openingHours": {
        "Monday": "8 AM to 5 PM",
        "Tuesday": "9 AM to 6 PM",
        "Wednesday": "8 AM to 5 PM",
        "Thursday": "9 AM to 6 PM",
        "Friday": "8 AM to 5 PM",
        "Saturday": "Closed",
        "Sunday": "Closed"
      },
      "website": "https://www.aloha-dental.com/",
      "postalCode": "78741",
      "relatedPlaces": [
        {
          "name": "Daylight Dental South Austin",
          "rating": 4.8,
          "reviews": 1094
        },
        {
          "name": "Magnolia Family Dentistry",
          "rating": 4.9,
          "reviews": 271
        }
      ],
      "address": "1614 E Riverside Dr, Austin, TX 78741",
      "socials": {
        "instagram": [
          "https://www.instagram.com/alohadentaltx"
        ],
        "facebook": [
          "https://www.facebook.com/people/Aloha-Dental-Texas"
        ],
        "youtube": null,
        "tiktok": null,
        "linkedin": null,
        "twitter": null,
        "pinterest": null
      },
      "reviews": 682,
      "reserveTableUrl": null,
      "similarHotels": [],
      "categoryId": "dental_clinic",
      "hotelAds": [],
      "country": "US",
      "businessName": "Aloha Dental"
    }
  ]
}
```

## Related APIs

For a place's review text use [`google-maps/reviews`](https://docs.mindcase.co/apis/google-maps/reviews).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.