Google Maps

Google Maps API

Public place reviews
with completeness context

Collect public Google Maps reviews with ratings, original language text and explicit delivery completeness context.

Review text in the reviewer's original language
Google's requested order and row rank
Completeness flags and expected counts when known

View the Actor Try the sample

Historical recordings · 1 recorded item in the saved sample

POST/acts/meka.im~google-maps-reviews-scraper/run-sync-get-dataset-items

Google Maps · place reviews

Google Maps · recorded sample

1 recorded item

Google Maps Reviews

Avery Rollins

3 months ago

Rating (1–5)

Tí Cafe is a quaint and cozy little café off of Broadway. It boasts a diverse amount of delectable teas, coffees, and pastries. A great place to go with friends and family. Staff was kind, professional, and helpful. Beware, they often have a line out the door starting around when they open as well as off and on continuing into the afternoon. It is difficult at times to find seating because of its high volumed nature. This café is sought after by many people. In the handful of times I have been there my favorite items have been the Banana Cream Pie Matcha Latte(a matcha latte presented with fresh cut banana, banana milk/custard, and what seems to be a Nilla-style cookie crumble over the top), paired with the Pandan Croissant. It is a perfect snack/pick me up to either start or end your day with. Highly recommend🖤🍵

The saved row is a historical fixture. Date text and author fields are shown exactly as recorded.

Recorded Sep 24, 2026Historical sample

Google Maps Reviews

Overview

What this API returns

Collect public Google Maps reviews with ratings, original language text and explicit delivery completeness context.

Contract version 2 is the default anonymous feed. It leaves time null because the original publication time is unavailable and isEdited null because edit status is unknown; updatedTime carries the observed update timestamp. Version 1 exposes the legacy cookie-feed fields.

incomplete marks a place that was known not to be fully delivered, and expected records the expected count when known. variant identifies the response variant but does not by itself guarantee completeness. Review text is never machine-translated.

Input

Place links or identifiers

Output

Public review rows

Send place identifiers

Provide Google Maps links, place IDs, CIDs or feature IDs, one place per line.

Read the requested order

The Actor follows Google's own order and records the requested sort and each row's rank.

Read reviews with context

The Dataset keeps the review text, rating, source timestamps and known completeness fields.

Use cases

Where these records fit

The record is designed to sit inside research and review workflows. The examples below are starting points, not packaged scores.

Voice-of-customer research

Read public review text and ratings for a place, then group themes in your own analysis.

text
rating
language

Reputation review

Compare recent public reviews and owner responses without treating a short response as complete coverage.

relativeTime
ownerResponse
incomplete

Review QA

Track delivery completeness context alongside the reviews that were returned.

variant
expected
contractVersion

Try it

Inspect a recorded review row

Read a saved public review, then inspect the original Dataset item as JSON. Completeness context stays visible.

Checking live preview

Enter a Google Maps place link or identifier.

POSThttps://api.apify.com/v2/acts/meka.im~google-maps-reviews-scraper/run-sync-get-dataset-items

Recorded sampleSep 24, 2026

Rendered

Recorded

Google Maps

1 record

Google Maps review

Avery Rollins

3 months ago

Read full text

Open reviewer profile

Rating

Preview notes (1)

Only an observed update time was returned. It is not treated as the original publication date.

Publication and delivery

Date text: 3 months ago
Observed update time: Jun 9, 2026, 17:26:32 UTC

Response details (7 fields)

Review

Review text in the language the reviewer wrote it in. This report shows returned review rows, not a complete list of a place's reviews.

Review text: Tí Cafe is a quaint and cozy little café off of Broadway. It boasts a diverse amount of delectable teas, coffees, and pastries. A great place to go with friends and family. Staff was kind, professional, and helpful. Beware, they often have a line out the door starting around when they open as well as off and on continuing into the afternoon. It is difficult at times to find seating because of its high volumed nature. This café is sought after by many people. In the handful of times I have been there my favorite items have been the Banana Cream Pie Matcha Latte(a matcha latte presented with fresh cut banana, banana milk/custard, and what seems to be a Nilla-style cookie crumble over the top), paired with the Pandan Croissant. It is a perfect snack/pick me up to either start or end your day with. Highly recommend🖤🍵
Rating (1–5): 5

Reviewer

Public reviewer identity as Google shows it; nothing is inferred.

Reviewer name: Avery Rollins
Reviewer profile URL: https://www.google.com/maps/contrib/103636067553999839366?hl=en

Publication and edits

time is the original publication time only when the contract supplies it. updatedTime is the observed update timestamp; contract 2 cannot determine original time or edit status.

Observed update time: Jun 9, 2026, 17:26:32 UTC
Relative time (Google wording): 3 months ago

Review identifier

Google review ID: Ci9DQUlRQUNvZENodHljRjlvT25WdFVtOTFaSGt0TlV0RlFrcHZaWFZFVFc1b1RWRRAB

Only returned fields are shown.

All returned fields

reviewId: Ci9DQUlRQUNvZENodHljRjlvT25WdFVtOTFaSGt0TlV0RlFrcHZaWFZFVFc1b1RWRRAB
rating: 5
text: Tí Cafe is a quaint and cozy little café off of Broadway. It boasts a diverse amount of delectable teas, coffees, and pastries. A great place to go with friends and family. Staff was kind, professional, and helpful. Beware, they often have a line out the door starting around when they open as well as off and on continuing into the afternoon. It is difficult at times to find seating because of its high volumed nature. This café is sought after by many people. In the handful of times I have been there my favorite items have been the Banana Cream Pie Matcha Latte(a matcha latte presented with fresh cut banana, banana milk/custard, and what seems to be a Nilla-style cookie crumble over the top), paired with the Pandan Croissant. It is a perfect snack/pick me up to either start or end your day with. Highly recommend🖤🍵
updatedTime: 2026-06-09T17:26:32.824Z
dateText: 3 months ago
authorName: Avery Rollins
authorUrl: https://www.google.com/maps/contrib/103636067553999839366?hl=en

Recorded Sep 24, 2026 · Historical snapshot · Source: Google Maps

JSON

Recordedapplication/json

1[2  {3    "reviewId": "Ci9DQUlRQUNvZENodHljRjlvT25WdFVtOTFaSGt0TlV0RlFrcHZaWFZFVFc1b1RWRRAB",4    "rating": 5,5    "text": "Tí Cafe is a quaint and cozy little café off of Broadway. It boasts a diverse amount of delectable teas, coffees, and pastries.\nA great place to go with friends and family.\nStaff was kind, professional, and helpful.\n\nBeware, they often have a line out the door starting around when they open as well as off and on continuing into the afternoon.\nIt is difficult at times to find seating because of its high volumed nature.\nThis café is sought after by many people.\n\nIn the handful of times I have been there my favorite items have been the Banana Cream Pie Matcha Latte(a matcha latte presented with fresh cut banana, banana milk/custard, and what seems to be a Nilla-style cookie crumble over the top), paired with the Pandan Croissant. It is a perfect snack/pick me up to either start or end your day with. Highly recommend🖤🍵",6    "updatedTime": "2026-06-09T17:26:32.824Z",7    "dateText": "3 months ago",8    "authorName": "Avery Rollins",9    "authorUrl": "https://www.google.com/maps/contrib/103636067553999839366?hl=en"10  }11]

Reference

Request and response contract

POST to the Apify Actor endpoint with a bearer token. Request examples use $APIFY_TOKEN and the current product defaults; response examples come from a saved historical record.

Parameters

Request fields accepted by the Actor. Preview input is sent only when you run a live request.

contractVersioninteger

Version 2 is the default anonymous feed. Original publication time and edit status are unknown (null). Choose 1 for the legacy cookie feed. A run cannot resume a Dataset or STATE created with the other version. Default: 2. Minimum: 1. Maximum: 2.

placesstring[]

One place per line. Four forms are accepted and all resolve to the same place: a Google Maps link (https://www.google.com/maps?cid=… or /maps/place/…), a ChIJ… place ID, a numeric CID, or a 0x…:0x… feature ID. Anything else is skipped, reported in the run summary, and never charged.

sortstring

All four are Google's own orders, not a re-sort on our side. Newest follows Google and orders by last edit time, which is what updatedTime carries. Default: "mostRelevant". Accepted: "mostRelevant", "newest", "highest", "lowest".

maxReviewsinteger

Upper bound per place. A place with fewer reviews returns what it has. Version 2 fetches up to 60 reviews per page; version 1 fetches 20. Default: 100. Minimum: 1. Maximum: 100000.

languagestring

BCP-47 code such as en, de, ja, pt-BR. This is Google's interface language: it changes the relative time wording ("3 weeks ago" vs "vor 3 Wochen") and the language Google would translate into. It does NOT filter reviews — review text always comes back in the language the reviewer wrote it in. Anything unrecognised falls back to en. Default: "en".

requireCompleteboolean

Legacy contract version 1 only. Google sometimes answers an anonymous session with a short five-review response that has no next page, which looks exactly like a genuine last page. On: retry with fresh sessions and, if the response is still short, mark every row incomplete: true. Off: accept the short response silently. Default: true.

placeConcurrencyinteger

How many places to scrape at the same time. Delivery order is preserved regardless. Default: 2. Minimum: 1. Maximum: 8.

sessionRetriesinteger

Legacy contract version 1 only. How many fresh sessions to try when Google returns a truncated response, before the Actor re-queues the whole place and starts over after a longer pause. The truncation is bound to the session, and swapping sessions within a couple of seconds tends to land on the same one, so a low number here plus the re-queue is both faster and more reliable than a high number. Default: 3. Minimum: 0. Maximum: 8.

retryDelayMsinteger

Legacy contract version 1 only. Pause before opening a fresh session. Retrying immediately lands on the same truncated variant more often. Default: 1500. Minimum: 0. Maximum: 10000.

sharedSessionExperimentboolean

Legacy contract version 1 only. Experimental opt-in. Reuses short-lived Google Maps sessions across Data Worker instances. Enable only for controlled latency and completeness comparisons. Default: false.

Response

Published response fields are listed below. The saved historical fixture may use different public field names and is shown unchanged.

reviewIdstringRequired

Google's own review id. Stable across sessions and sort orders, so it is the key to de-duplicate and join on.

Example: Ci9DQUlRQUNvZENodHljRjlvT25WdFVtOTFaSGt0TlV0RlFrcHZaWFZFVFc1b1RWRRAB

textstring | null

The review in the language the reviewer wrote it in. Not a machine translation.

Example: Tí Cafe is a quaint and cozy little café off of Broadway. It boasts a diverse amount of delectable teas, coffees, and pastries. A great place to go with friends and family. Staff was kind, professional, and helpful. Beware, they often have a line out the door starting around when they open as well as off and on continuing into the afternoon. It is difficult at times to find seating because of its high volumed nature. This café is sought after by many people. In the handful of times I have been there my favorite items have been the Banana Cream Pie Matcha Latte(a matcha latte presented with fresh cut banana, banana milk/custard, and what seems to be a Nilla-style cookie crumble over the top), paired with the Pandan Croissant. It is a perfect snack/pick me up to either start or end your day with. Highly recommend🖤🍵

languagestring | null

Language of text, as Google reports it.

ratingnumber | nullRequired

1 to 5.

Example: 5

timestring | nullRequired

Contract 2: null because the original publication time is unavailable. Contract 1: original publication time in ISO 8601 when available.

updatedTimestring | nullRequired

Observed update timestamp in ISO 8601, or null when unavailable. Contract 2 cannot determine original publication time or edit status. Contract 1 falls back to time for unedited reviews. Google's newest order follows this field.

Example: 2026-06-09T17:26:32.824Z

isEditedboolean | nullRequired

Contract 2: null because edit status is unknown. Contract 1: whether time and updatedTime differ.

relativeTimestring | null

Google's own wording, e.g. "2 months ago".

authorobjectRequired

Public reviewer identity as Google shows it on the review. Nothing inferred.

ownerResponseobject | null

The business reply, when there is one. Only a relative time is available.

imagesstring[]

Photo URLs attached to the review.

placeobjectRequired

Which place this review belongs to, plus the input it came from.

sortstringRequired

Which order this run requested.

pagenumber

page

ranknumber

Position within this place, in the requested order.

variantstring | nullRequired

Contract 2: full identifies the anonymous feed and does not guarantee completeness. Contract 1: full or teaser identifies the legacy response variant. See incomplete for known delivery limits.

incompletebooleanRequired

True when we know this place was not fully delivered. See the README on truncated responses.

expectednumber | null

expected

scrapedAtstringRequired

scrapedAt

contractVersionnumberRequired

contractVersion

requestedLanguagestring | null

Google interface language this run asked for. Review text is always the original language; this only affects relative time wording.

curl -X POST 'https://api.apify.com/v2/acts/meka.im~google-maps-reviews-scraper/run-sync-get-dataset-items' \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "places": [
    "0x876c7f16d35d7343:0xa4c93839c7da47c"
  ],
  "sort": "newest",
  "maxReviews": 50,
  "language": "en",
  "contractVersion": 2
}'

Recorded sample

1 recorded item · historical sample

[
  {
    "reviewId": "Ci9DQUlRQUNvZENodHljRjlvT25WdFVtOTFaSGt0TlV0RlFrcHZaWFZFVFc1b1RWRRAB",
    "rating": 5,
    "text": "Tí Cafe is a quaint and cozy little café off of Broadway. It boasts a diverse amount of delectable teas, coffees, and pastries.\nA great place to go with friends and family.\nStaff was kind, professional, and helpful.\n\nBeware, they often have a line out the door starting around when they open as well as off and on continuing into the afternoon.\nIt is difficult at times to find seating because of its high volumed nature.\nThis café is sought after by many people.\n\nIn the handful of times I have been there my favorite items have been the Banana Cream Pie Matcha Latte(a matcha latte presented with fresh cut banana, banana milk/custard, and what seems to be a Nilla-style cookie crumble over the top), paired with the Pandan Croissant. It is a perfect snack/pick me up to either start or end your day with. Highly recommend🖤🍵",
    "updatedTime": "2026-06-09T17:26:32.824Z",
    "dateText": "3 months ago",
    "authorName": "Avery Rollins",
    "authorUrl": "https://www.google.com/maps/contrib/103636067553999839366?hl=en"
  }
]

Recorded Sep 24, 2026 · historical snapshot

Pricing & access

Usage is billed through the Actor

Published FREE-plan event rates from public Apify metadata. Plan-specific rates and usage terms remain on the Actor's pricing page.

Pricing

Pay per delivered event

Apify FREE-plan rate

$0.50per 1,000 reviews

Per unique review delivered. Duplicates and empty results are free.

Checked 19 Oct 2026Apify pricing

Access

One POST endpoint

Authenticate with an Apify Bearer token.
Send a JSON body to the posted Actor endpoint.
Read the Dataset items array returned by the run.

https://api.apify.com/v2/acts/meka.im~google-maps-reviews-scraper/run-sync-get-dataset-items

FAQ

Questions about the contract

Authentication, response shape, recorded data and availability.

Why is the original review time null?

Contract version 2 cannot determine the original publication time or edit status. It exposes an observed updatedTime instead. Legacy contract version 1 keeps its original time fields when available.

What does incomplete mean?

incomplete is true when the Actor knows a place was not fully delivered. variant identifies the response variant, and expected gives the expected count when known; a short response is not presented as complete.

Are review texts translated?

No. Text is returned in the language the reviewer wrote. The language input changes Google's interface wording, not the review text.

How do I authenticate requests?

Send an Apify token as a Bearer token in the Authorization header, as shown in the request examples.

Are the results on this page live?

Not by default. Saved samples are historical recordings from the source; each keeps the fields and values from that record and does not verify current availability. Live data is requested directly from the published Apify Actor endpoint with your own token.

Where can I find current pricing?

Current pricing and usage terms are published on the Apify Actor page.