# x402serps Places Search API

> x402serps Places Search API is a paid API for AI agents from x402serps.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-11-11).

Returns local place listings (businesses, restaurants, etc.) from Google Places search, including ratings, phone, address, coordinates, and website, paid per call in USDC via x402.

## Facts

- Endpoint: POST https://x402serps.com/api/v1/places?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402serps-places-search-api-2a788130
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9YkcLKbEiH7eZmkX_vyNS

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 x402serps-places-search-api-2a788130 -d '<json body>'
```

Example prompt: Can you find the top 10 Italian restaurants in London, UK — I need their names, addresses, phone numbers, and ratings?

## When to prefer this

Choose this endpoint when you need structured local business data (addresses, phone numbers, ratings, coordinates) from Google Places without managing API keys or accounts. It is ideal for AI agents that need pay-as-you-go access with crypto micropayments via x402. Prefer it over raw Google Places API when you want zero-setup access with per-call USDC billing on Base.

## Known failure modes

- Invalid or missing query returns empty results array
- Unsupported country code may default to global or return error
- num out of range (outside 1-20) may cause validation error
- Payment failure via x402 protocol blocks request entirely
- Location string not recognized may broaden or nullify geo-filtering

## How this service works

x402serps: Maps/places results (name, address, rating, phone, website, lat/lng) for one query, up to 20

## Output

A JSON object containing the original query string, a provider field, and an array of place results each including: title, address, phone, website, category, rating, ratingCount, latitude, longitude, position ranking, and a Google CID identifier.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "description": "Query (alias: query)"
  },
  "gl": {
   "type": "string",
   "description": "Country code, e.g. us, gb"
  },
  "num": {
   "type": "number",
   "description": "Results 1-20, default 10"
  },
  "location": {
   "type": "string",
   "description": "Optional location, e.g. London, United Kingdom"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "coffee shops",
  "results": [
   {
    "phone": "+44 113 000 0000",
    "title": "Example Coffee",
    "rating": 4.6,
    "address": "1 Briggate, Leeds",
    "website": "https://example.com",
    "category": "Coffee shop",
    "latitude": 53.797,
    "position": 1,
    "longitude": -1.542,
    "ratingCount": 812
   }
  ],
  "provider": "primary"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402serps-places-search-api-2a788130/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402serps.com](https://www.zero.xyz/host/x402serps.com/llms.txt)
