scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTReviews

Google Maps Reviews

1 credit

Get reviews from Google Maps for a place.

POST/api/v1/tools/google/reviews

Parameters

urlstringrequired

Full Google Maps URL. Must contain a hex ID (e.g. !1s0x...:0x...). Copy the URL from your browser address bar.

maxReviewsnumber

Maximum number of reviews to return. Must be a positive integer. Defaults to 20. Upper bound is determined by your plan.

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.

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 (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/google/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": 1,
    "requestId": "req_abc123"
  }
}