↑ ↓ to move ↵ to open
Google Maps API · Endpoint

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.

  • 1 credit per call
  • Failed calls are free
  • Updated
  • googlemaps.place
Response completed
{  "name": "Empire State Building",  "rating": 4.7,  "review_count": 130259,  "address": "20 W 34th St., New York, NY 10001",  "cid": "15074921902713971043",  "feature_id": "0x89c259a9b3117469:0xd134e199a405a163",  "lat": 40.7484405,  "lng": -73.98566439999999,  "maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJaXQRs6lZwokRY6EFpJnhNNE",  "place_id": "ChIJaXQRs6lZwokRY6EFpJnhNNE",  "website": "https://www.esbnyc.com/",  "hours": [    {      "day": "Monday",      "hours": "10 AM–10 PM"    },    {      "day": "Tuesday",      "hours": "10 AM–10 PM"    }  ],  "types": [    "Observation deck",    "Historical landmark"  ]}
Try it live, free
Input

What you send

The input object of the request, with every field the endpoint accepts.

FieldTypeRequiredWhat it doesExample
query string one of The place's name and address, or its place ID, CID or feature ID from a search result. Empire State Building New York
url string one of A Google Maps link to the place, including short maps.app.goo.gl links.
country string no Two-letter country code, such as us or gb.
lang string no Language for names and labels, such as en or en-US.
Response

Fields it returns

What each record in the response holds, with the values from the sample above.

FieldTypeWhat it isExample
name string The place's name on Google Maps. Empire State Building
address string The place's address as Google Maps shows it. 20 W 34th St., New York, NY 10001
rating number The place's average star rating. 4.7
review_count integer How many reviews the place has. 130,259
website string The website the place links to. https://www.esbnyc.com/
lat number The place's latitude. 40.75
lng number The place's longitude. -73.99
place_id string Google's place ID for this place. ChIJaXQRs6lZwokRY6EFpJnhNNE
cid string Google Maps' numeric ID (CID) for the place. 15074921902713971043
feature_id string Google Maps' feature ID for the place; the reviews endpoint accepts it. 0x89c259a9b3117469:0xd134e199a405a163
hours array Opening hours, one entry per day. 7 records
hours[].day string The day of the week. Monday
hours[].hours string Opening hours on that day. 10 AM–10 PM
maps_url string A link to the place on Google Maps. https://www.google.com/maps/place/?q=place_id:ChIJaXQRs6lZwokRY…
types array The categories Google Maps lists for the place. Observation deck, Historical landmark, Historical place museum
REST API · MCP server

Call it from your code, or ask your agent

Set UPSCRAPE_API_KEY to your key and copy a working request.

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.place",  "input": {    "query": "Empire State Building New York"  }}'
In your AI agent Claude · Cursor · any MCP client
1Add the Upscrape MCP server
https://data.upscrape.com/mcp
2Ask for the data in plain words

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.

The agent finds the endpoint, shows you the price, and runs it with your credits.
Google Maps

More from the Google Maps API

Same data, other platforms

The same data from other platforms

Questions

Google Maps Place API FAQ

The short answers. The docs have the long ones.

Still have a question? Talk to the people who build the endpoints.
How much does the Google Maps Place API cost?

1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.

What do I send?

Every input is optional; the input fields below list what each one does.

Do I need a Google Maps login?

No. It reads public Google Maps data; nothing runs on your account.

Can my AI agent call it?

Yes, over MCP: the agent finds googlemaps.place, checks its price and runs it with the same credits as the REST API.

Get started

Your first Google Maps call is free.

Up to 100 free credits to start, no card needed.