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 20)

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"
  }
}