# PennyAPI Local Business & Places Search

> PennyAPI Local Business & Places Search is a paid API for AI agents from pennyregwatch.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-16).

Real-time local business and places search returning structured results including names, addresses, coordinates, ratings, categories, phone numbers, and websites

## Facts

- Endpoint: GET https://pennyregwatch.com/web/places
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pennyapi-local-business-places-search-b7cdbaa6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R3ldWgs3NFDzarCaWMIi8

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 pennyapi-local-business-places-search-b7cdbaa6
```

Example prompt: Find me the top 5 Italian restaurants in Austin, Texas — I need their names, addresses, ratings, and phone numbers.

## When to prefer this

Choose this endpoint when an AI agent needs structured, real-time local business data — especially names, addresses, coordinates, ratings, and contact info — without requiring API key setup or subscription management. Ideal for pay-per-call agentic workflows where keyless x402 micropayment access is preferred. Best suited for queries needing 1–10 results with optional country and language targeting.

## Known failure modes

- Missing required 'query' parameter returns an error response
- Invalid or unsupported country code may return no results or default to global search
- Low-specificity queries may return irrelevant or geographically mismatched results
- Insufficient USDC balance or x402 payment failure blocks the request
- Very rare or niche business types in small regions may return 0 results
- Rate limiting or upstream data provider outages may cause empty or delayed responses

## How this service works

Real-time local business and places search for AI agents. Find restaurants, coffee shops, stores, services, and nearby businesses with structured names, addresses, coordinates, ratings, categories, phone numbers, and websites where available. Send query, optional num, country, and lang as URL parameters. Keyless x402 pay-per-call; no API key, account, or subscription required.

## Output

Returns a JSON object with an array of up to 10 place results, each containing position rank, business title, address, latitude/longitude coordinates, category, rating score, rating count, phone number, and website URL where available, along with total count, query echo, retrieval timestamp, and latency in milliseconds.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "num": {
       "type": "integer",
       "default": 5,
       "maximum": 10,
       "minimum": 1
      },
      "lang": {
       "type": "string",
       "maxLength": 2,
       "minLength": 2,
       "description": "Optional 2-letter language code"
      },
      "query": {
       "type": "string",
       "description": "Local business or places search query"
      },
      "country": {
       "type": "string",
       "maxLength": 2,
       "minLength": 2,
       "description": "Optional 2-letter country code"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "tool": "penny_places",
  "count": 1,
  "query": "coffee shops in Houston",
  "places": [
   {
    "phone": "",
    "title": "Example Coffee",
    "rating": 4.7,
    "address": "Houston, TX",
    "website": "",
    "category": "Coffee shop",
    "latitude": 29.76,
    "position": 1,
    "longitude": -95.37,
    "rating_count": 100
   }
  ],
  "latency_ms": 420,
  "retrieved_at": "2026-09-10T14:00:00+00:00"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pennyapi-local-business-places-search-b7cdbaa6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pennyregwatch.com](https://www.zero.xyz/host/pennyregwatch.com/llms.txt)