scraper
Back to API docs

Overview

  • Overview

SERP

  • POSTSERP

Core

  • POSTGeocode
  • POSTTranslate
  • POSTSearch
  • POSTVision
  • POSTPlaces Search
  • POSTPlace Details
  • POSTPlaces Nearby
  • POSTAutocomplete

Maps

  • POSTSearch
  • POSTPlace Details
  • POSTReviews

Hotels

  • POSTSearch
  • POSTDetail
  • POSTReviews
  • POSTPhotos

Flights

  • POSTSearch
  • POSTCalendar
  • POSTExplore

Finance

  • POSTQuote
  • POSTFundamentals
  • POSTChart
  • POSTNews
  • POSTSearch
  • POSTEstimates
  • POSTEarnings

Places Nearby

1 credit

Find places near a specific location using Google Maps data.

POST/api/v1/tools/google/places/nearby

Parameters

locationstringrequired

Center point as "lat,lng" (e.g. "35.6762,139.6503")

radiusnumberrequired

Search radius in meters (1–50000)

typestring

Place type filter (e.g. "restaurant")

keywordstring

Keyword filter

languagestring

Language code for results

regionstring

CLDR region code (e.g. "US", "JP") for result formatting.

maxResultsnumber

Max results, 1-20 (default 20).

includedTypesstring[]

Place types to include (Table A types). Up to 50.

excludedTypesstring[]

Place types to exclude (Table A types). Up to 50.

includedPrimaryTypesstring[]

Primary place types to include (Table A types). Up to 50.

excludedPrimaryTypesstring[]

Primary place types to exclude (Table A types). Up to 50.

rankPreferencestring

How to rank results. "POPULARITY" (default) or "DISTANCE".

Response Schema

dataobject[]

Array of nearby places

placeIdstring

Google Place ID

namestring

Place name

addressstring

Formatted address

latnumber

Latitude

lngnumber

Longitude

ratingnumber

Average rating

typesstring[]

Place type tags

metaobject

Request metadata

toolstring

Tool name (places/nearby)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/google/places/nearby \
-H "Authorization: Bearer sc_live_..." \
-H "Content-Type: application/json" \
-d '{"location": "35.6592,139.6988", "radius": 1000, "type": "cafe"}'

Response Example

{
"data": [
{
"placeId": "ChIJ_zua6N2LGGAR04lCFnCTqqk",
"name": "About Life Coffee Brewers",
"address": "1-19-8 Dogenzaka, Shibuya City, Tokyo",
"lat": 35.6592,
"lng": 139.6988,
"rating": 4.3,
"types": [
"cafe",
"food",
"point_of_interest"
]
}
],
"meta": {
"tool": "google-places-nearby",
"creditsUsed": 1,
"requestId": "req_abc123"
}
}