Google Maps reviews by place id, URL, short link or name. One row per review: stars, text, owner replies, exact dates, translation, photos, reviewer. Free place row: rating, review count, completeness check. Free filters: date range, only new reviews, negative reviews, text-only, keywords, language.
Never billed past maxTotalChargeUsd: each charge asks the platform only for the reviews that still fit under the spending limit, under one lock shared by every concurrent place, and exactly those are delivered; the run then ends — spending limit reached. Apify SDK 4.2 answers a request for more events than still fit by billing one event past the limit (a $0.30 limit was billed $0.302 on google-hotels-prices on 2026-11-16), and a limit below the price of one review was billed one review. Runs without a spending limit, or whose limit is not reached, are unchanged: no prices, input fields, defaults or output fields changed.
1.3 — 2026-11-16
maxItems (sent by AI agents) now caps the primary rows delivered and charged; add-ons follow the delivered rows. maxItems is one total over every place (review rows only; the place and status rows stay free): places are looked up and read one at a time in the order given, the walk stops on the page that reaches maxItems (the place row says stopped_by: maxItems), and a place the cap never reaches is not looked up (its status row says limit). When maxReviewsPerPlace is left at its default (100) or at the form's example value (20), maxItems also raises it so the run can deliver up to maxItems reviews; any other maxReviewsPerPlace (or Compass maxReviews) stays, and the stricter cap wins. SUMMARY records max_items and the caps used. Without maxItems nothing changes: no prices, output fields, defaults or input fields changed.
1.2 — 2026-11-16
monitorKey is stored encrypted (secret input); no behaviour change. Google throttling (HTTP 429) now waits 2, 4 then 8 s before retrying on a fresh IP, and after 3 throttled tries in a row the run continues on Apify residential proxies (counted as http.escalated in SUMMARY); a place that stays blocked still fails the run with the same message. No prices, output fields, defaults or other inputs changed.
2026-11-13 — Restore previous listing keywords
Restore title, description and SEO text to the November 5 baseline at the owner’s request. Preserve current runtime fixes, input/output contracts, billing, prices and defaults.
2026-11-07 — Negative-review monitoring recipe
Document a bounded latest-20 one/two-star workflow, optional owner replies, first-run onlyNew state, stable monitorKey and the older-backlog boundary. Clarify delivery versus downstream processing and the external-ID-list limitation. README/input descriptions only; runtime, input fields/defaults, output and prices are unchanged.
2026-11-06 — MCP discovery metadata
Clarify supported search intents and output nouns in the Store listing. Runtime, input contract, output and prices are unchanged.
2026-11-06 — MCP discovery metadata
Clarify supported search intents and output nouns in the Store listing. Runtime, input contract, output and prices are unchanged.
Changelog
2026-10-16 — Keyword Planner and locale documentation
Validated search terminology against Google Ads Keyword Planner and Store shelves. Added localized usage guidance and bounded examples; retained existing English phrases. Clarified locale limitations where measured. No runtime, output fields, defaults, or pricing changed.
1.0 — listing and input form reworded, 2026-10-11
No behaviour, output or price changed; the same inputs return the same rows.
Title tail "Complete" (ranked #10–20) replaced by "Owner Reply"; "Date Range" and "New-Only" kept verbatim — they hold #1–#3 on seven Store queries.
Description rewritten for MCP agents: what one row is (stars, text, translation, exact dates, owner replies, photos, reviewer), the free place row (rating, review count, completeness check) and the free filters as nouns (date range, only new reviews, negative reviews, text-only, keywords, language); the price left to the pricing line.
seoDescription now carries the searchable synonyms (API, by place id, new reviews, negative reviews, CSV) and native nouns (reseñas, opiniones, avis, bewertungen).
Review event text names what is never charged (place and status rows, filtered reviews, duplicates, already-delivered reviews, unknown places, bad input), "No start fee" and the maxTotalChargeUsd stop.
Input form reordered so the first 20 fields are the selling capabilities (places, maxReviewsPerPlace, fromDate, toDate, sort, onlyNew, monitorKey, includeEdited, the eight free filters, translate, language, country, includePlaceRow); the Compass aliases (placeIds, startUrls) and proxy tuning sit below the fold. Every field description now gives a literal example, the default, what 0/empty means and what it costs.
README: new section "Google Maps reviews scraper for AI agents: which input answers which request?" (when to use, when not, request → input table, row fields, status contract); H1 = title.
1.0 — 2026-09-21
First release.
Places in any form: Google Maps URLs, maps.app.goo.gl / share.google short links, place ids, CIDs, feature ids, Maps search URLs, or a plain "name, city" — resolved by the actor, a pasted spreadsheet column accepted as it is.
One flat row per review with exact published_at / updated_at timestamps, the owner's reply and its date, likes, photos, the reviewer, sub-ratings and visit details.
A true date range (fromDate / toDate); the newest-first walk stops at fromDate.
New-only monitoring (onlyNew, monitorKey, includeEdited): each review is delivered once, and a run that finds nothing new charges $0.
A free place row per place with the listed total, the histogram, a completeness verdict and a 90-day rating trend; a free status row per input line.
Completeness check on every place, with a second pass in another sort order when a full walk is more than 2% short; zero duplicates; an empty page is never read as the end of the reviews.
Charged events always equal delivered review rows; the spending limit is honoured mid-place; unknown places and places without reviews are free.
Accepts the input of compass/google-maps-reviews-scraper (startUrls, placeIds, maxReviews, reviewsSort, reviewsStartDate, language).