# AgentAPI Places Search

> AgentAPI Places Search is a paid API for AI agents from api.agentapihub.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Search for places and businesses by text query, returning name, address, phone, and rating data

## Facts

- Endpoint: POST https://api.agentapihub.com/api/places/search
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentapi-places-search-eff30763
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZBJ-OLDaLAjMeNzi1TNko

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 agentapi-places-search-eff30763 -d '<json body>'
```

Example prompt: Find me up to 10 Starbucks locations in Miami and give me their addresses, phone numbers, and ratings.

## When to prefer this

Use this endpoint when you need to search for real-world businesses or places by keyword and need structured data (name, address, phone, rating) in return. Prefer this over geocoding APIs when the user wants to discover businesses rather than resolve a specific address.

## Known failure modes

- Empty query string returns validation error
- Limit value of 0 or negative may return empty or error response
- No matching places returns empty places array
- Overly broad query may return irrelevant results
- Rate limiting or payment failure returns 402 error

## How this service works

Search for places/businesses by text query

## Output

Returns a list of matching places, each with name, address, phone number, and star rating (e.g. 4.5).

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "required": [
    "method"
   ],
   "properties": {
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "places": [
  {
   "name": "Starbucks",
   "phone": "+1 305-555-1234",
   "rating": 4.5,
   "address": "123 Main St"
  }
 ]
}
```

## More

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