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.
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).
