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

Google Maps Nearby Search API

Find places around a point, nearest first, each with its distance in meters. Narrow it with a search term or place type and a radius.

  • 1 credit per call
  • Failed calls are free
  • Updated
  • googlemaps.nearby
Response completed
{  "summary": {    "has_more": true,    "outside_radius": 20,    "total_items": 20  },  "items": [    {      "name": "Restaurant el paisa",      "rating": 5,      "review_count": 1,      "address": "San Francisco, CA 94103",      "cid": "6539182198288680772",      "distance_m": 4,      "feature_id": "0x8085810029d5525b:0x5abfd790328e0744",      "lat": 37.7749295,      "lng": -122.4194155,      "maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJW1LVKQCBhYARRAeOMpDXv1o",      "place_id": "ChIJW1LVKQCBhYARRAeOMpDXv1o",      "types": [        "Coffee shop"      ]    },    {      "name": "All Star Cafe",      "rating": 4,      "review_count": 333,      "address": "1500 Market St, San Francisco, CA 94102",      "cid": "6955426026914760730",      "distance_m": 39,      "feature_id": "0x8085809e91ccf29b:0x6086a31ebbc2c81a",      "lat": 37.7752389,      "lng": -122.4195333,      "maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJm_LMkZ6AhYARGsjCux6jhmA",      "phone": "(415) 252-9888",      "place_id": "ChIJm_LMkZ6AhYARGsjCux6jhmA",      "hours": [        {          "day": "Monday",          "hours": "Open 24 hours"        },        {          "day": "Tuesday",          "hours": "Open 24 hours"        }      ],      "types": [        "Cafe",        "Donut shop"      ]    }  ]}
Try it live, free
Input

What you send

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

FieldTypeRequiredWhat it doesExample
lat number yes Latitude of the point to search around. 37.7749
lng number yes Longitude of the point to search around. -122.4194
country string no Two-letter country code, such as us or gb.
include_exclusion_summary boolean no Also count the places that were left out for being outside the radius.
lang string no Language for names and labels, such as en or en-US.
limit integer no How many places to return, up to 120. The default is 60. 20
query string no What to look for, such as coffee. coffee
radius integer no How far to look, in meters. Places farther away are left out. The default is 1,000. 500
types array<string> no Kinds of place to include, such as restaurant. They are combined with the search term.
Response

Fields it returns

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

FieldTypeWhat it isExample
items[].name string The place's name on Google Maps. Restaurant el paisa
items[].distance_m integer Distance from your point, in metres. 4
items[].address string The place's address as Google Maps shows it. San Francisco, CA 94103
items[].rating integer The place's average star rating. 5
items[].review_count integer How many reviews the place has. 1
items[].place_id string Google's place ID for this place. ChIJW1LVKQCBhYARRAeOMpDXv1o
items[].cid string Google Maps' numeric ID (CID) for the place. 6539182198288680772
items[].feature_id string Google Maps' feature ID for the place; the reviews endpoint accepts it. 0x8085810029d5525b:0x5abfd790328e0744
items[].lat number The place's latitude. 37.77
items[].lng number The place's longitude. -122.42
items[].maps_url string A link to the place on Google Maps. https://www.google.com/maps/place/?q=place_id:ChIJW1LVKQCBhYARR…
items[].types array The categories Google Maps lists for the place. Coffee shop
items array The places found. 20 records
summary object Totals for this response. 3 fields
summary.has_more boolean Whether Google had more places than this response holds. true
summary.outside_radius integer Places found beyond your radius, left out of the results. 20
summary.total_items integer How many places this response holds. 20
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.nearby",  "input": {    "lat": 37.7749,    "limit": 20,    "lng": -122.4194,    "query": "coffee",    "radius": 500  }}'
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

Using Upscrape, list the coffee places within 500 meters of 37.7749, -122.4194 on Google Maps, nearest first, with their distance and rating.

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

More from the Google Maps API

Questions

Google Maps Nearby Search 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 Nearby Search API cost?

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

What do I send?

Send lat and lng. The input fields below list every option with its type and limits.

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.nearby, 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.