{"uid":"cap_1-YPkiMycRllBQT-R2VYz","slug":"google-maps-reviews-scraper-x402-8ba85ca1","name":"Google Maps Reviews Scraper (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/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_ufF5LxRovR4B79VRBrUop","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 structured Google Maps place reviews by URL or place ID, returning review text, star ratings, and metadata with pay-per-call micropayment pricing.","exampleAgentPrompt":"Pull up to 5 Google Maps reviews for 'ChIJN1t_tDeuEmsRUsoyG83frY4' — only 4- and 5-star reviews, in English, and flag any that mention the word 'parking'.","exampleUseCases":[{"title":"Competitor reputation research","prompt":"Grab the latest Google Maps reviews for these three restaurant place IDs — ChIJabc123, ChIJdef456, ChIJghi789 — up to 5 reviews each, all star ratings, in English, so I can compare what customers are saying about our competitors."},{"title":"Negative review monitoring","prompt":"Scrape Google Maps reviews for my hotel listing at https://maps.google.com/?cid=12345678 and only return the 1-star and 2-star ones so I can see what complaints we need to address."},{"title":"Keyword-filtered review extraction","prompt":"Get Google Maps reviews for place ID ChIJXYZ999 filtered to only show reviews that mention 'wait time' — any star rating, in English, max 5 reviews — I want to understand the queuing experience customers are describing."}],"resultDescription":"Returns a JSON object with a count of results and an array of review items, each containing review text, star rating, review ID, publish date, review URL, review origin (Google or other), search string used, and translated text where available. The product field identifies this as a google-maps scrape.","failureModes":["Invalid or non-existent place ID returns empty items array (not charged)","Private or unavailable Google Maps listing returns no results (not charged)","Malformed URL in startUrls causes extraction failure","Language code not supported may fall back to default or return untranslated content","maxReviews capped at 5 per place regardless of input value above 5","Network or scraping block by Google returns empty run (not charged)"],"whenToPreferThis":"Choose this endpoint when you need structured review data from Google Maps — including text, star ratings, and metadata — for one or more specific places identified by URL or place ID. It is ideal for reputation monitoring, competitive analysis, sentiment input pipelines, and review aggregation workflows where you want pay-per-successful-call pricing with no charge on failed or empty runs. Prefer this over general web scraping tools when you specifically need Google Maps review data in a clean JSON format.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:14.151Z","isFirstParty":false,"canonicalSlug":"google-maps-reviews-scraper-x402-8ba85ca1"}