Google Maps Place API
Look up a place on Google Maps by name or search query (optionally scoped to a location) and get the best-matching place with available address, contact, rating, and coordinate details as normalized JSON.
$1.75/1k req, pay per request, no subscription.
{"name": "Blue Bottle Coffee","url": "https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo","placeId": "ChIJd7DoQL2AhYARW-mNQFPuGZo","address": "66 Mint St, San Francisco, CA 94103, USA","street": "66 Mint St","city": "San Francisco","state": "California","postalCode": "94103",... 15 more fields}
Pricing and providers
Google Maps Place API pricing: one API, 3 interchangeable providers
The cheapest provider serves first. If it fails, the next one takes over in the same call.
capped at $0.0099 per request1 result$0.00882 results$0.0099 capYou are charged for what comes back. Lower the limit to pay less - and no single request can cost more than the cap, however much comes back.
Try it
Get Google Maps place in one request
This sample shows 26 of 27 fields. See every field
{
"found": true,
"data": {
"items": [
{
"name": "Blue Bottle Coffee",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo",
"placeId": "ChIJd7DoQL2AhYARW-mNQFPuGZo",
"address": "66 Mint St, San Francisco, CA 94103, USA",
"street": "66 Mint St",
"city": "San Francisco",
"state": "California",
"postalCode": "94103",
"countryCode": "US",
"neighborhood": "SoMa",
"phone": "+1 415-555-0118",
"website": "https://bluebottlecoffee.com",
"category": "Coffee shop",
"categories": [
"Coffee shop",
"Cafe",
"Espresso bar"
],
"rating": 4.4,
"reviewsCount": 2937,
"latitude": 37.7825,
"longitude": -122.4058,
"image": "https://lh3.googleusercontent.com/places/ANXAkqHBlueBottleMint=w500-h375-k-no",
"priceLevel": "$$",
"plusCode": "QHGX+59 San Francisco, California",
"permanentlyClosed": false,
"hours": [
{
"day": "Monday",
"hours": "6:30 AM-6:00 PM"
},
{
"day": "Tuesday",
"hours": "6:30 AM-6:00 PM"
},
{
"day": "Wednesday",
"hours": "6:30 AM-6:00 PM"
},
{
"day": "Thursday",
"hours": "6:30 AM-6:00 PM"
},
{
"day": "Friday",
"hours": "6:30 AM-6:00 PM"
},
{
"day": "Saturday",
"hours": "7:00 AM-6:00 PM"
},
{
"day": "Sunday",
"hours": "7:00 AM-5:00 PM"
}
]
}
]
}
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-10-31 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- querystring
Blue Bottle Coffee
The business name or search text to look up, as you would type it into the Google Maps search bar (e.g. Blue Bottle Coffee).
- categoryFilterWordsarray
Optional list of Google Maps place-category names to keep; the match is limited to a place whose category is one of these. Use lowercase category names as shown on Google Maps (e.g. ["coffee shop"]). Omit to allow any category and stay on the cheapest price; a category filter routes to a dearer source.
- languagestring
Two-letter language code for the result details (e.g. en).
- locationstring
San Francisco, CA
Optional free-text location to scope the search, ideally city plus state or country (e.g. San Francisco, CA). Narrows the query to the best match in that area.
- placeMinimumStarsenum
Only match a place with at least this average rating: two (2+), twoAndHalf (2.5+), three (3+), threeAndHalf (3.5+), four (4+), or fourAndHalf (4.5+). Places with no reviews are excluded. Omit this field to stay on the cheapest price; a rating floor routes to a dearer source.
- requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `plusCode` or `postalCode`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a place that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
- websiteenum
Filter by whether the place lists a website: allPlaces (default), withWebsite (only if it has a website), or withoutWebsite (only if it has none). Omit this field, or send allPlaces, to stay on the cheapest price; withWebsite and withoutWebsite route to a dearer source.
Response
JSON, one example value per field.
The best-matching place for the query, with available address, contact, category, rating, opening-hours, and coordinate details. Up to one element (empty when nothing matched). Populated whenever the provider has data for the entity.
- addressstring
66 Mint St, San Francisco, CA 94103, USA
Full formatted street address. Populated whenever the provider has data for the entity.
- categoriesstring[]
Every Google Maps category listed for the place.
- categorystring
Coffee shop
Primary Google Maps category (e.g. Coffee shop). Populated whenever the provider has data for the entity.
- citystringcan require
San Francisco
- countryCodestringcan require
US
Two-letter country code.
- hoursobject[]
Opening hours by day: each element is an object with the day name and its hours.
- imagestring
https://lh3.googleusercontent.com/places/ANXAkqHBlueBottleMint=w500-h375-k-no
URL of the primary place photo.
- latitudenumber
37.7825
Populated whenever the provider has data for the entity.
- longitudenumber
-122.4058
Populated whenever the provider has data for the entity.
- namestring
Blue Bottle Coffee
Business or place name. Populated whenever the provider has data for the entity.
- neighborhoodstringcan require
SoMa
- permanentlyClosedbooleancan require
false
Whether the place is permanently closed.
- phonestring
+1 415-555-0118
Formatted phone number.
- placeIdstring
ChIJd7DoQL2AhYARW-mNQFPuGZo
Google Maps place id. Populated whenever the provider has data for the entity.
- plusCodestringcan require
QHGX+59 San Francisco, California
Google Plus Code for the location.
- postalCodestringcan require
94103
- priceLevelstring
$$
Price level indicator (e.g. a price range).
- ratingnumber
4.4
Average star rating.
- reviewsCountinteger
2937
Total number of reviews.
- statestringcan require
California
State or region name.
- streetstringcan require
66 Mint St
Street portion of the address.
- urlstring
https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo
Google Maps URL for the place. Populated whenever the provider has data for the entity.
- websitestring
https://bluebottlecoffee.com
Business website URL.
- foundboolean
true
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
About the Google Maps Place API
The AnyAPI Google Maps Place API returns Google Maps place data as normalized JSON from one POST call to /v1/run/maps.place. Look up a place on Google Maps by name or search query (optionally scoped to a location) and get the best-matching place with available address, contact, rating, and coordinate details as normalized JSON. AnyAPI routes each request across 3 sources and falls back automatically when one fails. It costs from $1.75 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of Google Maps place calls through AnyAPI succeeded, with a median response time of 2.9 seconds across 120,743 measured calls.