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

Google Maps Reviews

2 credits

Get reviews from Google Maps for a place.

POST/api/v1/tools/google/maps/reviews

Parameters

urlstringrequired

Google Maps URL with an embedded hex ID or Place ID, or a bare Google Place ID.

maxReviewsnumber

Maximum number of reviews to return. Must be from 1 through 1000 and must not exceed your plan limit. Defaults to 20.

numberOfPagesnumber

Maximum number of review pages to fetch. Must be from 1 through 50. Omit to stop only at maxReviews or the last page.

sortstring

Sort order for reviews. One of "relevant", "newest", "highest", "lowest". Defaults to "newest".

searchQuerystring

Keyword search within review text. Defaults to "" (no filter).

reviewsNewerThanstring

Only return reviews newer than this date string. Omit to skip.

reviewsOlderThanstring

Only return reviews older than this date string. Omit to skip.

languagestring

BCP-47 language code for localized results (e.g. "en", "ja", "fr"). Defaults to "en".

regionstring

ISO 3166-1 alpha-2 region code (e.g. "US", "JP", "FR"). Defaults to "US".

fieldsstring[]

Fields to include per review. Omit for defaults: reviewId, rating, text, publishedAt, author, engagement, ownerResponse. Use ["*"] for all fields. Available fields: reviewId, rating, text, publishedAt, author, engagement, ownerResponse, url, lastEditedAt, relativeDate, textTranslated, language, originalLanguage, translatedLanguage, photos, visitedIn, visitedYear, visitedMonth, reviewOrigin, originalLanguageName, translatedLanguageName, details, meta.

Response Schema

dataobject

Google Maps reviews result

placeobject | null

Place information (name, address, rating, etc.)

reviewsobject[]

Array of review objects. Fields depend on the fields parameter. Default fields: reviewId, rating, text, publishedAt, author, engagement, ownerResponse.

countnumber

Number of reviews returned

totalReviewsnumber | null

Total number of reviews for this place

truncatedboolean

True if results were cut short due to a timeout or server limit. Only present when truncation occurred.

metaobject

Request metadata

toolstring

Tool name (google-maps-reviews)

creditsUsednumber

Credits consumed (2)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/google/maps/reviews \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.google.com/maps/place/.../@.../data=!...!1s0x608...:0x...",
    "maxReviews": 10,
    "sort": "newest"
  }'

Response Example

{
  "data": {
    "place": {
      "name": "Central Park",
      "placeId": "ChIJ4zGFAZpYwokRGUGph3Mf37k",
      "rating": 4.8,
      "totalReviewCount": 245812
    },
    "reviews": [
      {
        "reviewId": "ChdDSUhNMG9nS0VJQ0FnSUN4X2NiWjlBRRAB",
        "rating": 5,
        "text": "Beautiful park with so many things to do. The Bethesda Fountain area is stunning.",
        "publishedAt": "2026-04-07T10:30:00.000Z",
        "author": {
          "name": "Jane D.",
          "id": "112345678901234567890",
          "isLocalGuide": true,
          "reviewCount": 45
        },
        "engagement": {
          "likes": 12
        },
        "ownerResponse": null
      }
    ],
    "count": 1,
    "totalReviews": 245812,
    "truncated": true
  },
  "meta": {
    "tool": "google-maps-reviews",
    "creditsUsed": 2,
    "requestId": "req_abc123"
  }
}