# agdata Google Maps Reviews API

> agdata Google Maps Reviews API 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 ratings, text, and metadata

## Facts

- Endpoint: POST https://agdata.shveik.dev/v1/x402/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-api-38ca1af7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_m-RYMoSY_wbRFPYp6sHW1

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-api-38ca1af7 -d '<json body>'
```

Example prompt: Pull the 20 most recent Google Maps reviews for Eleven Madison Park — use this Maps URL: https://maps.google.com/?cid=1234567890 — and give me the star ratings and review text.

## When to prefer this

Choose this endpoint when you need structured Google Maps review data — with full metadata like owner responses, detailed ratings, language, and timestamps — without scraping or maintaining a browser. It is ideal for business intelligence, reputation monitoring, sentiment analysis pipelines, or travel/hospitality research where Google Maps is the authoritative review source. Prefer it over general web scraping when you need clean, machine-readable review JSON rather than raw HTML.

## Known failure modes

- Invalid or unresolvable place URL/place_id returns an error or empty results
- Place not found on Google Maps returns no reviews
- Limit exceeding 50 is rejected by schema validation
- Language code not recognized may default or return an error
- Rate limiting or payment failure (x402) halts the request
- Private or removed places return no data

## 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

A JSON array of review objects, each containing: review text, translated text (if applicable), star rating (1–5), review ID, published timestamp and relative age, image count, likes count, owner response, detailed sub-ratings, place metadata, and original/translated language fields.

## 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-api-38ca1af7/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)