# agdata Google Maps Search

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

Search Google Maps for places by query and location, returning structured place data including ratings, addresses, hours, and contact info

## Facts

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

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-search-30df3081 -d '<json body>'
```

Example prompt: Find me the top 5 coffee shops in Prague 7 on Google Maps — I need their names, addresses, ratings, and phone numbers.

## When to prefer this

Use this endpoint when you need structured Google Maps place data (ratings, hours, contact info, coordinates) without a Google Maps API key or monthly subscription. Ideal for AI agents that need to pay per call in USDC stablecoins via x402 with no account setup. Prefer over direct Google Maps API when avoiding API key management, or when you need clean structured JSON output ready for agent consumption rather than raw Maps API responses.

## Known failure modes

- No results found for the given query and location combination
- Location string is ambiguous or unrecognized, returning wrong area results
- Limit exceeds maximum of 20 causing validation error
- Payment not processed or insufficient USDC balance causing 402 rejection
- Rate limiting or temporary Google Maps data unavailability causing 503
- Query or location exceeds character limits causing 400 bad request

## 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 a list of place objects, each containing: place name, address, city, phone number, website URL, Google Maps place ID, latitude/longitude coordinates, overall rating score, review count, category name, price level, and opening hours schedule.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 20,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "maxLength": 500
  },
  "location": {
   "type": "string",
   "maxLength": 500
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://…",
  "city": "Prague 7…",
  "phone": "",
  "price": null,
  "title": "The Mine…",
  "address": "Pod Dráh…",
  "placeId": "ChIJ5f89…",
  "website": "https://…",
  "location": {},
  "totalScore": 4.8,
  "categoryName": "Coffee s…",
  "openingHours": [],
  "reviewsCount": 183
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agdata-google-maps-search-30df3081/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)
