# Places API Text Search

> Places API Text Search is a paid API for AI agents from places-api.x402hub.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Searches for places by text query and returns a list of matching location results

## Facts

- Endpoint: POST https://places-api.x402hub.xyz/api/places/text-search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/places-api-x402hub-xyz-cdb82da4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oTmwjUTABk_UDPc1FhsGE

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 places-api-x402hub-xyz-cdb82da4 -d '<json body>'
```

Example prompt: Find me up to 5 Italian restaurants in downtown Chicago — search for 'Italian restaurant Chicago downtown' and return the top results.

## When to prefer this

Use this endpoint when you need to search for places, businesses, or points of interest by free-text query and want to control how many results are returned. Ideal for location discovery tasks where the user has a keyword or phrase in mind rather than exact coordinates.

## Known failure modes

- Missing required 'query' field returns validation error
- Missing required 'limit' field returns validation error
- Empty query string may return no results
- Limit set to 0 or negative may return error or empty list
- Overly vague query may return irrelevant or no results
- Payment failure via x402 protocol blocks the request

## Output

A list of place results matching the text query, up to the specified limit, likely including place names, addresses, and related location metadata.

## More

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