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

  • POSTOne-way Search
  • POSTCalendar
  • POSTExplore

Finance

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

Place Details

0.6 credits

Get detailed information about a place from Google Maps by its Place ID.

POST/api/v1/tools/google/places/details

Parameters

placeIdstringrequired

Google Place ID (alphanumeric, dashes, underscores). Get IDs from Places Search or Autocomplete.

fieldMaskstring[]

Advanced Google Places API field-mask override. Omit it to derive the mask from fields. Use it only to control Google API billing tiers.

fieldsstring[]

Fields to return. Omit for defaults: placeId, name, types, primaryType, address, lat, lng, rating, ratingCount, phone, website, googleMapsUrl, hours, reviews, photos, summary, services, businessStatus, priceLevel. Use ["*"] for all fields.

languagestring

Language code for results

Response Schema

dataobject

Place details

placeIdstring

Google Place ID

namestring

Place name

addressstring

Formatted address

phonestring

Phone number

websitestring

Website URL

ratingnumber

Average rating (1–5)

totalRatingsnumber

Total number of ratings

priceLevelnumber

Price level (0–4)

openNowboolean

Whether currently open

reviewsobject[]

User reviews

photosobject[]

Place photos

metaobject

Request metadata

toolstring

Tool name (places/details)

creditsUsednumber

Credits consumed (0.6)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/google/places/details \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"placeId": "ChIJ_zua6N2LGGAR04lCFnCTqqk"}'

Response Example

{
  "data": {
    "placeId": "ChIJ_zua6N2LGGAR04lCFnCTqqk",
    "name": "About Life Coffee Brewers",
    "address": "1-19-8 Dogenzaka, Shibuya City, Tokyo 150-0043",
    "phone": "+81 3-6809-0751",
    "website": "https://aboutlifecoffeebrewers.com",
    "rating": 4.3,
    "totalRatings": 812,
    "priceLevel": 1,
    "openNow": true,
    "reviews": [
      {
        "author": "John D.",
        "rating": 5,
        "text": "Amazing pour-over coffee...",
        "relativeTime": "2 weeks ago"
      }
    ]
  },
  "meta": {
    "tool": "google-places-details",
    "creditsUsed": 0.6,
    "requestId": "req_abc123"
  }
}