# Google Maps Search & Extract

> Google Maps Search & Extract is a paid API for AI agents from ZeroClick x402 Service Registry at maps.withzero.ai, paid per call via MPP, $0.003/call, status unknown (last checked 2026-10-12, last successful call 2026-09-21).

Search for local businesses on Google Maps by query, or extract detailed business info and reviews from a Google Maps URL

## Facts

- Endpoint: POST https://maps.withzero.ai/run?utm_source=zero.xyz
- Price: $0.003/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-12
- Last successful call: 2026-09-21
- Success rate: 73% of calls made through Zero
- Rating: 4.4 / 5 from 10 reviews
- Activations on Zero: 43141
- Provider: ZeroClick x402 Service Registry
- Website: https://withzero.ai
- Tags: data, google-maps, places, local, business, reviews, restaurants
- Canonical page: https://www.zero.xyz/c/zeroclick-x402-service-registry-google-maps-search-extract-27f4d555
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wftjGPRpqV-_uvb34hYDi

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 zeroclick-x402-service-registry-google-maps-search-extract-27f4d555 -d '<json body>'
```

Example prompt: Search Google Maps for 'best sushi restaurants near Union Square New York' and give me their names, ratings, and addresses as structured data.

## When to prefer this

Use this endpoint when you need structured Google Maps data — either searching for local businesses by keyword/location or extracting details and reviews from a specific Google Maps listing. Prefer this over general web search when you need standardized fields like ratings, hours, and addresses. Ideal for local business discovery, competitive research, or review aggregation tasks.

## Known failure modes

- Invalid or inaccessible Google Maps URL returns an error or empty results
- Search query returns zero results if too specific or misspelled
- Rate limits or BrightData scraping blocks may cause delays or empty responses
- Providing both url and query may cause ambiguous mode selection
- Requesting reviews for a business with no reviews returns an empty results array

## How this service works

Search local businesses and places on Google Maps. Extract full business details and reviews from any Google Maps URL. Search mode: provide a query string to find places on Google Maps. Extract mode: provide a Google Maps URL and choose what to extract — places (business details) or reviews. Powered by BrightData. Returns structured JSON with business names, addresses, ratings, hours, and more.

## Output

A JSON object with mode ('search' or 'extract'), the original query or URL, result count, latency in milliseconds, and a results array containing structured business data from BrightData — including names, addresses, ratings, hours, and optionally reviews.

## Example request

```json
{
 "query": "coffee shops near Times Square New York"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "Google Maps URL for data extraction"
  },
  "query": {
   "type": "string",
   "description": "Search query for Google Maps (e.g. \"pizza near Times Square\")"
  },
  "extract": {
   "enum": [
    "places",
    "reviews"
   ],
   "type": "string",
   "default": "places",
   "description": "What to extract when using url (default: places)"
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "mode",
  "query",
  "url",
  "resultCount",
  "latencyMs"
 ],
 "properties": {
  "url": {
   "type": "string",
   "nullable": true,
   "description": "The Google Maps URL (null if search mode)"
  },
  "mode": {
   "type": "string",
   "description": "'search' or 'extract'"
  },
  "query": {
   "type": "string",
   "nullable": true,
   "description": "The search query (null if extract mode)"
  },
  "results": {
   "description": "Structured data returned by BrightData"
  },
  "latencyMs": {
   "type": "number",
   "description": "Time taken in milliseconds"
  },
  "resultCount": {
   "type": "number",
   "description": "Number of results returned"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zeroclick-x402-service-registry-google-maps-search-extract-27f4d555/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from maps.withzero.ai](https://www.zero.xyz/host/maps.withzero.ai/llms.txt)