Places Search

1 credit

Search for places by text query using Google Maps data.

POST/api/v1/tools/google/places/search

Parameters

querystringrequired

Search query (e.g. "pizza near Times Square")

locationstring

Center point as "lat,lng"

radiusnumber

Search radius in meters (1–50000)

typestring

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

languagestring

Language code for results

maxResultsnumber

Max results per request, 1-20 (default 10)

openNowboolean

Only return places that are currently open.

minRatingnumber

Minimum average user rating (0.0-5.0).

priceLevelsstring[]

Filter by price level. Values: PRICE_LEVEL_FREE, PRICE_LEVEL_INEXPENSIVE, PRICE_LEVEL_MODERATE, PRICE_LEVEL_EXPENSIVE, PRICE_LEVEL_VERY_EXPENSIVE.

rankPreferencestring

How to rank results. "RELEVANCE" or "DISTANCE".

regionstring

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

strictTypeFilteringboolean

When true, only return results matching the type exactly.

includePureServiceAreaBusinessesboolean

Include businesses without a physical storefront.

evOptionsobject

EV charging filters. Properties: connectorTypes (string[]), minimumChargingRateKw (number).

Response Schema

dataobject[]

Array of places

placeIdstring

Google Place ID

namestring

Place name

addressstring

Formatted address

latnumber

Latitude

lngnumber

Longitude

ratingnumber

Average rating (1–5)

totalRatingsnumber

Total number of ratings

typesstring[]

Place type tags

metaobject

Request metadata

toolstring

Tool name (places/search)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/google/places/search \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"query": "coffee shops in Shibuya", "maxResults": 5}'

Response Example

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

curl -X POST https://scraper.run/api/v1/tools/google/places/search \

-H "Authorization: Bearer sc_live_..." \

-H "Content-Type: application/json" \

-d '{"query": "coffee shops in Shibuya", "maxResults": 5}'

{

"data": [

{

"placeId": "ChIJ_zua6N2LGGAR04lCFnCTqqk",

"name": "About Life Coffee Brewers",

"address": "1-19-8 Dogenzaka, Shibuya City, Tokyo 150-0043",

"lat": 35.6592,

"lng": 139.6988,

"rating": 4.3,

"totalRatings": 812,

"types": [

"cafe",

"food",

"point_of_interest"

]

}

"meta": {

"tool": "google-places-search",

"creditsUsed": 1,

"requestId": "req_abc123"

}