# agdata Google Maps Reviews

> agdata Google Maps Reviews is a paid API for AI agents from agdata.shveik.dev, paid per call via x402, $0.01505/call, status unknown (last checked 2026-10-16).

Fetches up to 50 Google Maps reviews for a given place, returned as structured JSON with star ratings, text, timestamps, and owner responses.

## Facts

- Endpoint: POST https://agdata.shveik.dev/v1/mpp/google-maps-reviews?utm_source=zero.xyz
- Price: $0.01505/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agdata-google-maps-reviews-38aaadd9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MhBU3Xd5uG1SCR_mc_Ayo

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 agdata-google-maps-reviews-38aaadd9 -d '<json body>'
```

Example prompt: Can you grab the 20 most recent Google Maps reviews for Tartine Bakery in San Francisco — I want the star ratings, review text, and any owner replies?

## When to prefer this

Choose this endpoint when you need structured Google Maps review data — including star ratings, timestamps, owner responses, and language metadata — for a specific place identified by a place_id or Maps URL, without managing a Google API key or dealing with anti-scraping measures. Prefer it over raw web scraping when you need clean JSON output with no parsing overhead, and over the Google Places API when you need more than 5 reviews or want sorting by newest/highest/lowest.

## Known failure modes

- Invalid or unresolvable place identifier returns an error or empty results
- Place not found on Google Maps returns empty array
- Language code not recognized may fall back to default or return error
- Limit exceeding maximum of 50 is rejected with validation error
- Network timeout or upstream Google Maps unavailability returns HTTP 5xx
- Payment failure (insufficient USDC balance) blocks the request before execution

## How this service works

Unblock any URL as Markdown, or get search, social, maps, jobs and news as data. Paid per call in stablecoins over x402 or MPP, with no account.

## Output

Returns an array of review objects, each containing: review text, translated text (if applicable), star rating (1–5), review ID, published date and relative time, likes count, image count, owner response (if any), detailed sub-ratings, original and translated language codes, and a nested place object with location metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "newest",
    "relevant",
    "highest",
    "lowest"
   ],
   "type": "string"
  },
  "limit": {
   "type": "integer",
   "maximum": 50,
   "minimum": 1
  },
  "place": {
   "type": "string",
   "maxLength": 2048
  },
  "language": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "text": "there is…",
  "place": {},
  "stars": 5,
  "origin": "Google",
  "context": {},
  "reviewId": "Ci9DQUlR…",
  "imageCount": 0,
  "likesCount": 0,
  "publishedAt": "2026-10-…",
  "publishedAgo": "3 hours…",
  "ownerResponse": null,
  "detailedRating": {},
  "textTranslated": null,
  "originalLanguage": "en",
  "translatedLanguage": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agdata-google-maps-reviews-38aaadd9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agdata.shveik.dev](https://www.zero.xyz/host/agdata.shveik.dev/llms.txt)