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

Fetch up to 50 Google Maps reviews for a place by place_id or URL, returning stars, review text, translations, dates, likes, and owner replies as JSON

## Facts

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

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-e2a8a91b -d '<json body>'
```

Example prompt: Pull the 20 most recent Google Maps reviews for ChIJN1t_tDeuEmsRUsoyG83frY4 — include the owner replies and translate any non-English reviews to English.

## When to prefer this

Choose this endpoint when you need structured review data from Google Maps — star ratings, review text with translations, dates, likes, and owner replies — for a specific place identified by place_id or Google Maps URL. It is ideal for reputation monitoring, competitive analysis, sentiment aggregation, or surfacing customer feedback for a known location. Prefer it over generic web scraping when you need clean, consistently structured review JSON rather than raw HTML, and when the place is already identified (no search needed).

## Known failure modes

- Invalid or unresolvable place_id returns an error or empty result
- Place URL that cannot be parsed returns a bad request error
- Place exists but has zero reviews — call is not charged
- Requested limit exceeds 50 — validation error
- Unsupported language code may result in untranslated text
- Rate limiting or upstream Google Maps unavailability returns a 5xx error

## How this service works

Google Maps reviews API for AI agents: send a place_id or a Google Maps place URL and get up to 50 reviews as JSON: stars, text and its translation, date, likes, the owner's reply, plus the place's name, address and rating. Sort by newest, relevant, highest or lowest. Reviewer names, profiles and photos are not returned. A place with no reviews is not charged; reviews you paid for but did not get are refunded.

## Output

A JSON object containing the place's name, address, and overall rating, plus an array of up to 50 reviews each with: star rating, review text, translated text, review date, like count, and owner reply (if any). Places with no reviews are not billed; missing paid reviews are refunded.

## 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-e2a8a91b/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)