Google Maps Places Search API
Search Google Maps by keyword and place, such as coffee shops in San Francisco.
Sendquery
Returnsnameaddressphoneratingreview_countwebsite
1 credit
Web & maps · REST API · MCP server
Google Maps API
Search Google Maps the way a person does and get every place back as clean JSON: name, address, phone, website, hours, rating and coordinates. No Google Cloud project and no API key from Google.
- 1 credit per call
- Failed calls are free
- Updated
googlemaps.search
20 rows
completed
| # | Name | Address | Phone | Rating | Reviews | Website | Place ID | Cid | Lat | Lng |
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | The Coffee Movement | 1737 Balboa St, San Francisco, CA 94121 | 4.8 | 637 | https://www.thecoffeemovement.com/ | ChIJTfb1d_uHhYARRpn5d_Fk1SU | 2726196137705445702 | 37.78 | -122.48 | |
| 2 | The Coffee Berry SF | 1410 Lombard St, San Francisco, CA 94123 | (415) 800-7073 | 4.9 | 657 | http://thecoffeeberrysf.com/ | ChIJC2jb8DWBhYARo4AAX78U50c | 5181132708478222499 | 37.8 | -122.42 |
| 3 | Paper Son Coffee | 303 2nd St N102, San Francisco, CA 94107 | (415) 355-4463 | 4.7 | 195 | http://papersoncoffee.com/ | ChIJXVRIc9aBhYARDuJoNx2IVAg | 600254309412168206 | 37.79 | -122.4 |
| 4 | Better Half Coffee | 1448 Pacific Ave, San Francisco, CA 94109 | 4.9 | 131 | https://betterhalf.coffee/ | ChIJrcoKeYqBhYAReNsG0XWfYZs | 11196405476986641272 | 37.8 | -122.42 | |
| 5 | Saint Frank Coffee | 2340 Polk St, San Francisco, CA 94109 | (415) 881-8062 | 4.5 | 1403 | http://www.saintfrankcoffee.com/ | ChIJmfgIQ-iAhYARq5osc-JybBo | 1904023059391355563 | 37.8 | -122.42 |
| 6 | Third Wheel Coffee | 991 Oak St, San Francisco, CA 94117 | 4.9 | 267 | http://www.thirdwheel.coffee/ | ChIJXVOcv9SBhYAR84QtGtCafxk | 1837357391573517555 | 37.77 | -122.44 | |
| 7 | Hedge Coffee | 434 Shotwell St, San Francisco, CA 94110 | (415) 603-9818 | 4.6 | 368 | http://hedge.coffee/ | ChIJN6Ruz-2AhYARgtds57VLcVw | 6661188568501507970 | 37.76 | -122.42 |
| 8 | Compton’s Coffee House | 1910 Fillmore St, San Francisco, CA 94115 | (415) 416-6173 | 4.7 | 385 | https://comptonscoffeehouse.com/ | ChIJ844xLVCBhYARnhgW3uG5GqU | 11897025745397356702 | 37.79 | -122.43 |
| 9 | Ocean Beach Cafe | 734 La Playa St, San Francisco, CA 94121 | (415) 753-9352 | 4.7 | 816 | https://www.oceanbeachcafe.com/ | ChIJg4qwGKeHhYARo41FFI_aOss | 14644257446403870115 | 37.77 | -122.51 |
| 10 | The Coffee Movement | 1030 Washington St, San Francisco, CA 94108 | 4.7 | 1416 | https://www.thecoffeemovement.com/ | ChIJoTMb3PKAhYARsXkQt469sBw | 2067360649617373617 | 37.79 | -122.41 |
googlemaps.place
completed
namestringEmpire State Building
addressstring20 W 34th St., New York, NY 10001
ratingnumber4.7
review_countinteger130,259
websitestringhttps://www.esbnyc.com/
latnumber40.75
lngnumber-73.99
place_idstringChIJaXQRs6lZwokRY6EFpJnhNNE
cidstring15074921902713971043
typesstringObservation deck, Historical landmark, Historical place museum,…
feature_idstring0x89c259a9b3117469:0xd134e199a405a163
maps_urlstringhttps://www.google.com/maps/place/?q=place_id:ChIJaXQRs6lZwokRY…
googlemaps.nearby
20 rows
completed
| # | Name | Distance (m) | Address | Rating | Reviews | Place ID | Cid | Lat | Lng | Phone |
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | Restaurant el paisa | 4 | San Francisco, CA 94103 | 5 | 1 | ChIJW1LVKQCBhYARRAeOMpDXv1o | 6539182198288680772 | 37.77 | -122.42 | |
| 2 | All Star Cafe | 39 | 1500 Market St, San Francisco, CA 94102 | 4 | 333 | ChIJm_LMkZ6AhYARGsjCux6jhmA | 6955426026914760730 | 37.78 | -122.42 | (415) 252-9888 |
| 3 | The Buoy | 107 | 22 Franklin St, San Francisco, CA 94102 | 4.3 | 178 | ChIJK84-R6qBhYARWHOHDki2w6Y | 12016648651352273752 | 37.77 | -122.42 | (415) 416-9409 |
| 4 | Blue Bottle Coffee | 136 | 55 S Van Ness Ave, San Francisco, CA 94103 | 3.7 | 99 | ChIJ1VGyjmCBhYAR_pOL0q5shVs | 6594796727466431486 | 37.77 | -122.42 | (510) 661-3510 |
| 5 | Daily Grind Cafe | 179 | 1455 Market St UNIT 600, San Francisco, CA 94103 | ChIJAQDAM5yAhYARcTPJj6jdUhc | 1680649326999188337 | 37.78 | -122.42 | (619) 697-0750 | ||
| 6 | Nina's Cafe | 210 | 201 Fell St, San Francisco, CA 94102 | 4.2 | 26 | ChIJ-TgPKp-AhYARQOzi70ltCmk | 7568982288074206272 | 37.78 | -122.42 | (415) 437-2734 |
| 7 | Doppio Coffee & Brunch | 214 | 1551 Mission St, San Francisco, CA 94103 | 4.8 | 510 | ChIJy8vmGC2BhYARu919i3bko-Q | 16475263059648961979 | 37.77 | -122.42 | (628) 867-7985 |
| 8 | Zuni Café | 242 | 1658 Market St, San Francisco, CA 94102 | 4.3 | 2656 | ChIJO7u9q5-AhYARiSSXyWv9eJ8 | 11491213088621274249 | 37.77 | -122.42 | (415) 552-2522 |
| 9 | LOQUAT | 264 | 198 Gough St, San Francisco, CA 94102 | 4.6 | 415 | ChIJ81fzsc-BhYARdZtCXcbJ-7E | 12825066217672973173 | 37.77 | -122.42 | (415) 932-6816 |
| 10 | Andersen Bakery | 288 | 1390 Market St Ste b, San Francisco, CA 94102 | 4 | 81 | ChIJa3aIDJyAhYARMPjFJtHsI5I | 10530520736765179952 | 37.78 | -122.42 | (415) 757-0090 |
googlemaps.enrich
completed
namestringApple Park
confidencestringhigh
addressstringOne Apple Park Way, Cupertino, CA 95014
phonestring(408) 996-1010
websitestringhttp://www.apple.com/
ratingnumber4.3
review_countinteger8237
cidstring4255201883087866096
latnumber37.33
lngnumber-122.01
typesstringCorporate campus, Computer repair service, Electronics store, M…
feature_idstring0x808fb596e9e188fd:0x3b0d8391510688f0
maps_urlstringhttps://www.google.com/maps/place/?q=place_id:ChIJ_Yjh6Za1j4AR8…
place_idstringChIJ_Yjh6Za1j4AR8IgGUZGDDTs
Endpoints
Google Maps API endpoints
What each one takes and what it returns. Open one for a real response, every input and every field.
Google Maps Place API
Get one place from its name, address, place ID or a Google Maps link: address, phone, website, opening hours, rating, review count, categories and coordinates.
Sendqueryorurlorcountry
Returnsnameaddressratingreview_countwebsitelat
1 credit
Google Maps Nearby Search API
Find places around a point, nearest first, each with its distance in meters.
Sendlatandlng
Returnsnamedistance_maddressratingreview_countplace_id
1 credit
Google Maps Enrich Business API
Match a business name, with an optional city and state, to its Google Maps listing and get its address, phone, website, hours, rating and a confidence for the match.
Sendbusiness_name
Returnsnameconfidenceaddressphonewebsiterating
1 credit
Use cases
What teams build with Google Maps data
-
Local lead lists
Pull every dentist, gym or restaurant in a city with phone, website and rating, ready for your CRM.
Places searchPlace -
Clean up company records
Match the businesses you already have to Google Maps and fill in address, phone, website and hours.
Enrich businessPlace -
Competitor and store mapping
Map where competitors are, how they are rated and how busy their reviews are, area by area.
Places searchNearby search -
Site and delivery planning
See what sits around an address or a coordinate, nearest first, before you open a store or set a delivery zone.
Nearby searchPlace
Know before you build
How Google Maps data behaves
- What Google Maps showsEach place carries what its listing shows publicly. A place with no website or phone on Google Maps comes back without one.
- Nearby keeps to the radiusPlaces outside the radius you set are left out, so a nearby list never drifts into the next area.
- Ratings at the moment of the callRatings and review counts are Google Maps' own numbers when you call, so they move over time.
- Matches come with confidenceEnrich returns its best match and how sure it is. Add a city and state for common names and check the low ones.
REST API · MCP server
Call it from your code, or ask your agent
One request shape for every Google Maps endpoint: the endpoint ID and its input. No SDK needed.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "googlemaps.search", "input": { "limit": 20, "location": "San Francisco, CA", "query": "coffee shops" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "googlemaps.search", "input": { "limit": 20, "location": "San Francisco, CA", "query": "coffee shops" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "googlemaps.search", "input": { "limit": 20, "location": "San Francisco, CA", "query": "coffee shops" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
Response
{ "summary": { "has_more": true, "total_items": 20 }, "items": [ { "name": "The Coffee Movement", "rating": 4.8, "review_count": 637, "address": "1737 Balboa St, San Francisco, CA 94121", "cid": "2726196137705445702", "feature_id": "0x808587fb77f5f64d:0x25d564f177f99946", "lat": 37.7764721, "lng": -122.47782249999999, "maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJTfb1d_uHhYARRpn5d_Fk1SU", "place_id": "ChIJTfb1d_uHhYARRpn5d_Fk1SU", "website": "https://www.thecoffeemovement.com/", "hours": [ { "day": "Monday", "hours": "7 AM–2 PM" }, { "day": "Tuesday", "hours": "7 AM–2 PM" } ], "types": [ "Coffee shop" ] }, { "name": "The Coffee Berry SF", "rating": 4.9, "review_count": 657, "address": "1410 Lombard St, San Francisco, CA 94123", "cid": "5181132708478222499", "feature_id": "0x80858135f0db680b:0x47e714bf5f0080a3", "lat": 37.8014124, "lng": -122.4249979, "maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJC2jb8DWBhYARo4AAX78U50c", "phone": "(415) 800-7073", "place_id": "ChIJC2jb8DWBhYARo4AAX78U50c", "website": "http://thecoffeeberrysf.com/", "hours": [ { "day": "Monday", "hours": "7 AM–6 PM" }, { "day": "Tuesday", "hours": "7 AM–6 PM" } ], "types": [ "Coffee shop" ] } ]}
In your AI agent
Claude · Cursor · any MCP client
1Add the Upscrape MCP server
2Ask for the data in plain words
The agent finds the endpoint, shows you the price, and runs it with your credits.
https://data.upscrape.com/mcp
Use Upscrape to find coffee shops in San Francisco on Google Maps. Give me a table of name, address, phone, website and rating, best rated first.
With Upscrape, look up the Empire State Building on Google Maps and tell me its address, opening hours, rating and how many reviews it has.
Using Upscrape, list the coffee places within 500 meters of 37.7749, -122.4194 on Google Maps, nearest first, with their distance and rating.
Web & maps
More web & maps scraper APIs
BuiltWith
Google Trends
Greenhouse Jobs
Instahyre Jobs
Internshala Public Jobs
SmartRecruiters Jobs
Universal Web
Workday Jobs
Questions
Google Maps API FAQ
The short answers. The docs have the long ones.
Still have a question?
Talk to the people who build the endpoints.
Is this the official Google Maps Places API?
No. Upscrape reads public Google Maps listings, so you get places, addresses, phones, websites, hours and ratings as JSON without a Google Cloud project, a Google API key or its billing.
How many places can I get from one search?
Up to 120 places per call. For a larger area, run the search for each neighbourhood or around several points with the nearby endpoint.
Can I search outside the United States?
Yes. Set country and lang to the market you want, and add a location or coordinates for the area. The country leans results towards that market rather than filtering them.
Do I need a Google account?
No. You send a search, a place or a coordinate and get JSON back. Nothing runs on your account.
What data can I get from Google Maps?
Places search, place, nearby search and enrich business. Each is its own endpoint with a published input schema, and the response is JSON.
How much does the Google Maps API cost?
Every Google Maps endpoint costs 1 credit per successful call. You buy credits once, with no subscription, and paid credits never expire. New accounts get free credits to try it.
Can an AI agent use the Google Maps API?
Yes. Connect any MCP client to the Upscrape MCP server with OAuth or an API key. The agent finds the Google Maps endpoint, checks its price and runs it with the same credits as the REST API.
Is it legal to scrape Google Maps?
Upscrape reads public pages only and needs no login. How you use the data is yours to decide under the laws that apply to you; we sign a data processing agreement for your legal review.
Get started
Your first Google Maps call is free.
Up to 100 free credits to start, no card needed.