# Google Maps Business Search (Async)

> Google Maps Business Search (Async) is a paid API for AI agents from x402.orthogonal.com, paid per call via x402, $6/call, status unknown (last checked 2026-10-17).

Starts an async Google Maps business search by query across the USA or specific areas, returning up to 10,000 business results polled via a separate endpoint.

## Facts

- Endpoint: POST https://x402.orthogonal.com/fiber/v1/google-maps-search/start?utm_source=zero.xyz
- Price: $6/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/google-maps-business-search-async-71446f50
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3SiyqxqdXrlIGJcVk_sLi

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 google-maps-business-search-async-71446f50 -d '<json body>'
```

Example prompt: Search Google Maps for all 'urgent care clinics' across the whole USA and return up to 500 results — I want to build a nationwide directory.

## When to prefer this

Use this endpoint when you need to bulk-scrape Google Maps business listings for a specific query across wide geographic areas (whole USA or multiple cities). Prefer this over real-time search APIs when you need large result sets (up to 10,000) and can tolerate async polling. Ideal for lead generation, competitive analysis, franchise mapping, or building business directories.

## Known failure modes

- Invalid or missing query returns 400 error
- Unsupported strategy object format causes validation failure
- maxResults exceeding 10000 is rejected
- Insufficient USDC balance triggers payment failure
- Poll endpoint must be called separately — this endpoint only starts the job
- Search returning zero results if query is too specific or area has no matches

## How this service works

Start a search on Google Maps. Searches businesses by query across specified areas. Charges 3 credits ($0.06) per business found. Async: poll with /google-maps-search/poll.

## Output

Returns a job/poll ID that can be used with the /google-maps-search/poll endpoint to retrieve the async results. Final results include business listings with names, addresses, and place details scraped from Google Maps, up to the requested maxResults count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "description": "Optional project name for reference"
  },
  "query": {
   "type": "string",
   "description": "Search query for Google Maps (e.g. 'dominos pizza'). Do not include location."
  },
  "strategy": {
   "type": "object",
   "description": "Search strategy. Use {\"strategy\":\"whole-usa\"} or {\"strategy\":\"specific-areas\",\"unionAll\":[...]}"
  },
  "maxResults": {
   "type": "integer",
   "description": "Max results to return (default 100, max 10000)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/google-maps-business-search-async-71446f50/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.orthogonal.com](https://www.zero.xyz/host/x402.orthogonal.com/llms.txt)