# Official Google APIs

Places API (New), Business Profile API, pricing, field masks

# Places API (New) — Overview & Pricing

## Places API (New)

The current-generation API replacing the legacy Places API. Uses a mandatory **field mask** in every request — omitting it returns an error. Billing is determined by the highest-tier field requested.

### Three-Tier SKU Billing

<table id="bkmrk-tierwhat%27s-includedc"><tr><th>Tier</th><th>What's Included</th><th>Cost</th></tr><tr><td>**Essentials**</td><td>Place ID, name, address, location, types, business status</td><td>Lowest</td></tr><tr><td>**Pro**</td><td>Phone, website, opening hours, price level, photos</td><td>Medium</td></tr><tr><td>**Enterprise**</td><td>Reviews, ratings, userRatingCount, editorial summary, atmosphere data</td><td>Highest (~$17-35/1K requests)</td></tr></table>

### Subscription Plans

<table id="bkmrk-plancostcallssavings"><tr><th>Plan</th><th>Cost</th><th>Calls</th><th>Savings</th></tr><tr><td>Pay-as-you-go</td><td>Variable</td><td>Unlimited</td><td>Baseline</td></tr><tr><td>Starter</td><td>$100/mo</td><td>50K</td><td>Moderate</td></tr><tr><td>Pro</td><td>$1,200/mo</td><td>250K</td><td>Up to $5,000 vs PAYG</td></tr><tr><td>Enterprise</td><td>Custom</td><td>Custom</td><td>Negotiated</td></tr></table>

### Key API Operations

- **Place Details** — full data for a known place\_id
- **Text Search** — search by query string (e.g., "restaurants in Berlin")
- **Nearby Search** — search within a radius of coordinates
- **Autocomplete** — predictive place suggestions
- **Place Photos** — retrieve photos by reference

### Rate Limits

Enforced **per API method per project** (unlike legacy API which aggregated all methods). Default ~600 requests/minute; increases require contacting Google support.

### Free Tier Status (2026)

**Warning:** The previously documented "$200 monthly credit" and "10,000 free calls" claims were both refuted during adversarial verification. Verify directly at [mapsplatform.google.com/pricing](https://mapsplatform.google.com/pricing/).

### Data Fields (50+)

Name, formatted address, address components, phone, international phone, website, opening hours (regular + secondary), business status, price level, rating, user rating count, reviews (text/author/rating/time/language — **max 5 per place**), photos, types, coordinates, viewport, place ID, URL, UTC offset, plus 20+ boolean amenities (delivery, dineIn, takeout, outdoorSeating, liveMusic, allowsDogs, etc.).

#### New-Only Fields (Not in Legacy API)

`regularSecondaryOpeningHours`, `paymentOptions`, `parkingOptions`, `subDestinations`, `fuelOptions`, `evChargeOptions`, `shortFormattedAddress`, `primaryType`, `primaryTypeDisplayName`

### Sources

- [Usage and Billing](https://developers.google.com/maps/documentation/places/web-service/usage-and-billing)
- [Data Fields Reference](https://developers.google.com/maps/documentation/places/web-service/data-fields)
- [Operations Overview](https://developers.google.com/maps/documentation/places/web-service/op-overview)
- [Maps Platform Pricing](https://mapsplatform.google.com/pricing/)

# Google Business Profile API

## Google Business Profile API

Access **all reviews** (not limited to 5) — but only for locations you own or manage. Requires OAuth2 authentication.

### Key Endpoints

<table id="bkmrk-endpointpurpose-acco"><tr><th>Endpoint</th><th>Purpose</th></tr><tr><td>`accounts.locations.reviews.list`</td><td>All reviews for one location</td></tr><tr><td>`accounts.locations.batchGetReviews`</td><td>Batch review extraction across locations</td></tr></table>

Returns: reviewId, starRating, comment text, creation/update timestamps. Free for business owners.

### Google Takeout Alternative

Business owners can download all reviews from their GBP as JSON via Google Takeout (free, official).

Source: [Business Profile API — Review Data](https://developers.google.com/my-business/content/review-data)