Google Maps Search API
Search Google Maps for places matching a query and location: up to 20 normalized place records with ratings, addresses, and contact basics per request.
$1.75/1k req, pay per request, no subscription.
{"placeId": "ChIJrX7cX9C1RIYR2LFEjaLyeuY","cid": "8234917364550128200","name": "Mañana Coffee House","url": "https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY","category": "Coffee shop","categories": [...],"address": "612 W 6th St, Austin, TX 78701, USA","street": "612 W 6th St",... 14 more fields}
Pricing and providers
Google Maps Search API pricing: one API, 4 interchangeable providers
The cheapest provider serves first. If it fails, the next one takes over in the same call.
capped at $0.116 per request1 result$0.0058411 results$0.0636421 results$0.116 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 search in one request
This sample shows 24 of 26 fields. See every field
{
"found": true,
"data": {
"items": [
{
"placeId": "ChIJrX7cX9C1RIYR2LFEjaLyeuY",
"cid": "8234917364550128200",
"name": "Mañana Coffee House",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY",
"category": "Coffee shop",
"categories": [
"Coffee shop",
"Breakfast restaurant",
"Bakery"
],
"address": "612 W 6th St, Austin, TX 78701, USA",
"street": "612 W 6th St",
"city": "Austin",
"state": "Texas",
"postalCode": "78701",
"countryCode": "US",
"latitude": 30.2687,
"longitude": -97.7469,
"phone": "+1 512-555-0142",
"website": "https://mananacoffeeaustin.com",
"rating": 4.6,
"reviewCount": 1284,
"priceLevel": "$$",
"permanentlyClosed": false,
"image": "https://lh3.googleusercontent.com/places/ANXAkqHmananaCoffee6thSt=w400-h300-k-no"
},
{
"placeId": "ChIJq6qq6X61RIYRXVfIhGlJ7YQ",
"cid": "5127740981263455000",
"name": "Radio Coffee & Beer",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJq6qq6X61RIYRXVfIhGlJ7YQ",
"category": "Coffee shop",
"categories": [
"Coffee shop",
"Bar"
],
"address": "4204 Menchaca Rd, Austin, TX 78704, USA",
"street": "4204 Menchaca Rd",
"city": "Austin",
"state": "Texas",
"postalCode": "78704",
"countryCode": "US",
"latitude": 30.2277,
"longitude": -97.7808,
"phone": "+1 512-555-0187",
"website": "https://radiocoffeeandbeer.com",
"rating": 4.7,
"reviewCount": 3021,
"priceLevel": "$$",
"permanentlyClosed": false,
"image": "https://lh3.googleusercontent.com/places/ANXAkqHRadioCoffeeBeerPatio=w400-h300-k-no"
},
{
"placeId": "ChIJgUbEo8cKRIYRZ4h8dQ3jL2s",
"name": "Summer Moon Coffee",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJgUbEo8cKRIYRZ4h8dQ3jL2s",
"category": "Coffee shop",
"categories": [
"Coffee shop"
],
"address": "1900 Aldrich St Ste 100, Austin, TX 78723, USA",
"street": "1900 Aldrich St Ste 100",
"city": "Austin",
"state": "Texas",
"postalCode": "78723",
"countryCode": "US",
"latitude": 30.296,
"longitude": -97.7028,
"website": "https://summermooncoffee.com",
"rating": 4.5,
"reviewCount": 642,
"priceLevel": "$",
"permanentlyClosed": false,
"image": "https://lh3.googleusercontent.com/places/ANXAkqHSummerMoonAldrich=w400-h300-k-no"
}
]
}
}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.
- locationstring
Austin, TX
Free-text location to search in, ideally city plus country (e.g. Austin, USA).
- querystring
coffee shop
What you would type in the Google Maps search bar (e.g. coffee shop).
- categoryFilterWordsarray
Optional list of Google Maps place-category names to keep; results are limited to places whose category matches one of these. Use lowercase category names as shown on Google Maps (e.g. ["coffee shop", "restaurant"]). Omit to include all categories and stay on the cheapest price; a category filter routes to a dearer source.
- languagestring
Two-letter language code for the results (e.g. en).
- limitinteger
3
Maximum number of results to return (1-20, default 20). Pricing depends on the selected provider and may be flat per request.
- placeMinimumStarsenum
Only return places 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 `cid` or `street`, 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 places by whether they list a website: allPlaces (default), withWebsite (only places that have a website), or withoutWebsite (only places without one). 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.
Matching Google Maps place records. Populated whenever the provider has data for the entity.
- addressstring
612 W 6th St, Austin, TX 78701, USA
Full formatted street address.
- categoriesstring[]
Every Google Maps category listed for the place.
- categorystring
Coffee shop
Primary place category (e.g. Coffee shop).
- cidstringcan require
8234917364550128200
Google customer/place id (cid).
- citystringcan require
Austin
City the place is in.
- countryCodestringcan require
US
Two-letter country code.
- hoursobject[]can require
Opening hours by day: each element is an object with the day name and its hours.
- imagestring
https://lh3.googleusercontent.com/places/ANXAkqHmananaCoffee6thSt=w400-h300-k-no
Primary place photo URL.
- latitudenumber
30.2687
Latitude of the place in decimal degrees.
- longitudenumber
-97.7469
Longitude of the place in decimal degrees.
- namestring
Mañana Coffee House
Place name. Populated whenever the provider has data for the entity.
- permanentlyClosedbooleancan require
false
True when the place is marked permanently closed.
- phonestringcan require
+1 512-555-0142
Business phone number in E.164 format, when listed.
- placeIdstring
ChIJrX7cX9C1RIYR2LFEjaLyeuY
Google Maps place id (stable identifier for the place). Populated whenever the provider has data for the entity.
- postalCodestringcan require
78701
Postal code of the place.
- priceLevelstringcan require
$$
Relative price level indicator (e.g. $, $10-20).
- ratingnumber
4.6
Average star rating out of 5.
- reviewCountnumber
1284
Total number of reviews.
- statestringcan require
Texas
State or region the place is in.
- streetstringcan require
612 W 6th St
Street line of the address.
- urlstring
https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY
Canonical Google Maps URL for the place. Populated whenever the provider has data for the entity.
- websitestring
https://mananacoffeeaustin.com
The place's own website URL, when listed.
- foundboolean
true
True when the search returned at least one matching place.
- 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.
Selling this API? See the full schema your endpoint must return.
FAQ
About the Google Maps Search API
The AnyAPI Google Maps Search API returns Google Maps search data as normalized JSON from one POST call to /v1/run/maps.search. Search Google Maps for places matching a query and location: up to 20 normalized place records with ratings, addresses, and contact basics per request. AnyAPI routes each request across 4 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 search calls through AnyAPI succeeded, with a median response time of 2.8 seconds across 117,210 measured calls.