# Google Maps Reviews Scraper

> Google Maps Reviews Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes and returns structured review data (text, star rating, review ID, publish date) from Google Maps place pages via URL or place ID.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/google-maps?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/google-maps-reviews-scraper-8f2e8c4c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LsNn6pMPLKz7WYtHgzwkk

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability google-maps-reviews-scraper-8f2e8c4c -d '<json body>'
```

Example prompt: 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'.

## When to prefer this

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

## Known failure modes

- 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

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/google-maps-reviews-scraper-8f2e8c4c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)