# x402.orth.sh Google Places Search

> x402.orth.sh Google Places Search is a paid API for AI agents from x402.orth.sh, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14, last successful call 2026-07-22).

Searches Google Places via Serper to return local business listings with names, addresses, phone numbers, ratings, review counts, hours, categories, and Google CIDs.

## Facts

- Endpoint: POST https://x402.orth.sh/serper/places
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Last successful call: 2026-07-22
- Success rate: 100% of calls made through Zero
- Activations on Zero: 15
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-orth-sh-google-places-search-440a1e6c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mnlOdoSVriAdYUzY2t6rN

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 x402-orth-sh-google-places-search-440a1e6c -d '<json body>'
```

Example prompt: Find me the top 10 coffee shops near downtown Seattle, WA — I need their names, addresses, phone numbers, ratings, and hours, searching in English with US results.

## When to prefer this

Use this endpoint when you need structured local business data including CIDs, phone numbers, hours, and ratings from Google Places — especially when you need CID values to subsequently fetch reviews. Prefer over Google Maps endpoint when business contact details and operating hours are the primary need rather than raw map coordinates.

## Known failure modes

- No results found for query in the given location — empty results array returned
- Invalid or unsupported country/language code causes malformed results
- Missing or vague query returns irrelevant listings
- Coordinates formatted incorrectly (not @lat,lng,zoom) causes geolocation to fail
- Payment of 0.002 USDC not processed — 402 Payment Required error
- Rate limiting or upstream Serper quota exceeded returns error response

## How this service works

Google Places search - returns local businesses with names, addresses, phone numbers, ratings, review counts, hours, categories, and cids. Use for finding local businesses, restaurants, services. Returns cid values needed for the Reviews endpoint.

## Output

Returns a list of local business records each containing: business name, address, phone number, star rating, review count, business hours, category tags, and Google CID (which can be used to fetch detailed reviews via the Reviews endpoint).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "description": "Search query (e.g. \"coffee shops\", \"pizza near me\")"
  },
  "gl": {
   "type": "string",
   "description": "Country code (e.g. us, uk, de)"
  },
  "hl": {
   "type": "string",
   "description": "Language code (e.g. en, es, fr)"
  },
  "ll": {
   "type": "string",
   "description": "Latitude/longitude with zoom (e.g. \"@37.7749,-122.4194,15z\")"
  },
  "lr": {
   "type": "string",
   "description": "Restrict results to language (e.g. lang_en)"
  },
  "num": {
   "type": "number",
   "description": "Number of results (default 10)"
  },
  "page": {
   "type": "number",
   "description": "Page number for pagination For later pages of the same logical search, keep non-pagination parameters unchanged and pass top-level parentRequestId from the first Orthogonal /v1/run response."
  },
  "location": {
   "type": "string",
   "description": "Location name for localized results (e.g. \"San Francisco, CA\")"
  },
  "autocorrect": {
   "type": "boolean",
   "description": "Enable autocorrect (default true)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-orth-sh-google-places-search-440a1e6c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.orth.sh](https://www.zero.xyz/host/x402.orth.sh/llms.txt)