{"uid":"cap_LsNn6pMPLKz7WYtHgzwkk","slug":"google-maps-reviews-scraper-8f2e8c4c","name":"Google Maps Reviews Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/google-maps?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"stars":{"type":"array","items":{"type":"integer","maximum":5,"minimum":1},"default":[],"description":"Optional star ratings from 1 to 5. Empty means every rating in the preview."},"language":{"type":"string","default":"en","description":"Language code used for the Maps page and returned review display."},"maxItems":{"type":"integer","default":0,"minimum":0,"description":"Maximum reviews across all places. Zero means no total cap."},"placeIds":{"type":"array","items":{"type":"string"},"default":[],"description":"Optional Google Maps place IDs."},"startUrls":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","title":"URL","description":"Google Maps place URL."}}},"description":"Public Google Maps place or place-ID URLs. Each place currently yields up to five preview reviews."},"maxReviews":{"type":"integer","default":5,"maximum":5,"minimum":1,"description":"Maximum preview reviews to emit per place. The current public response exposes up to five."},"reviewsOrigin":{"enum":["all","google"],"type":"string","default":"all","description":"Keep all public reviews or only reviews shown as Google reviews."},"reviewsFilterString":{"type":"string","default":"","description":"Optional case-insensitive keyword matched against preview review text."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"text":null,"stars":null,"reviewId":null,"publishAt":null,"reviewUrl":null,"reviewOrigin":null,"searchString":null,"textTranslated":null}],"product":"google-maps"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_r2TSmIBLkgMH1luhvFcMA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes and returns structured review data (text, star rating, review ID, publish date) from Google Maps place pages via URL or place ID.","exampleAgentPrompt":"Pull the latest Google Maps reviews for ChIJN1t_tDeuEmsRUsoyG83frY4 — give me up to 5 reviews, only 1-star and 2-star ratings, in English, and filter for reviews mentioning 'wait'.","exampleUseCases":[{"title":"Competitor reputation monitoring","prompt":"Get me up to 5 Google Maps reviews for the place at https://www.google.com/maps/place/?q=place_id:ChIJN1t_tDeuEmsRUsoyG83frY4, showing only 1-star and 2-star reviews in English so I can see what customers complain about."},{"title":"Multi-location sentiment analysis","prompt":"Scrape Google Maps reviews for these three place IDs: ChIJN1t_tDeuEmsRUsoyG83frY4, ChIJdd4hrwug4tERDPqPmKxBEQU, and ChIJLU7jZClu5kcR4PcOOO6p4I0 — give me up to 5 reviews each, all star ratings, in English."},{"title":"Keyword-filtered customer feedback","prompt":"Fetch Google Maps reviews for https://maps.google.com/?cid=10281119596374313554 and only return reviews that mention the word 'parking' — I want all star ratings, up to 5 reviews, in English."}],"resultDescription":"Returns a JSON object with a count of items and an array of review objects, each containing: review text, star rating (integer 1-5), review ID, publish date, review URL, review origin (Google or other), search string used, and translated text if applicable. Null fields indicate data not available in the public preview.","failureModes":["Invalid or non-existent place ID returns empty items array (not charged)","Place URL not publicly accessible returns empty result (not charged)","maxReviews capped at 5 — requests for more will be silently capped","Language code not supported may fall back to default English","Keyword filter yields no matching reviews — empty items returned (not charged)","Rate limiting or scraping blocks from Google Maps may return empty result"],"whenToPreferThis":"Use this endpoint when you need structured Google Maps review data (text, stars, dates) for one or more specific places and want pay-per-successful-call pricing. Prefer this over general web scrapers when you need reviews parsed into clean fields rather than raw HTML, and when you have Google Maps URLs or place IDs readily available. Best suited for reputation monitoring, competitive analysis, and sentiment data pipelines at small-to-medium scale (up to 5 preview reviews per place per call).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:43.716Z","isFirstParty":false,"canonicalSlug":"google-maps-reviews-scraper-8f2e8c4c"}