# SelfOperate Nearby Businesses

> SelfOperate Nearby Businesses is a paid API for AI agents from tools.selfoperate.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-20).

Returns a list of local businesses near a given location, filtered by category, with contact details and confidence scores

## Facts

- Endpoint: GET https://tools.selfoperate.com/v1/nearby-businesses?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/selfoperate-nearby-businesses-f5dfe169
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eiVvNuGZxp7AB5y7YLxY5

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 selfoperate-nearby-businesses-f5dfe169
```

Example prompt: Find me the closest dentists in Austin, TX — search within 5km and return up to 10 results with their phone numbers and websites.

## When to prefer this

Choose this endpoint when you need structured, paid-on-demand local business discovery with category filtering and no signup overhead. It is ideal for AI agents that need real business contact data (phone, website, address) for a specific category near a geographic point. Prefer this over free geocoding APIs when confidence scores and multi-source attribution matter, or when you need to query dozens of locations programmatically and pay per call in USDC without managing API keys or subscriptions.

## Known failure modes

- Missing required 'category' parameter returns a validation error
- Invalid or unrecognized US city/state/ZIP with no lat/lon fallback may return zero results
- Radius outside 0.5–10km range may be rejected or clamped
- Category value not in the allowed enum list returns a 400-level error
- Payment failure via x402 USDC results in 402 response with no data
- Remote areas or small towns may return zero businesses for niche categories
- Limit outside 1–50 range may be rejected

## How this service works

Pay-per-call API for AI agents: site check, page brief, business verify, local business profile, nearby businesses, company dossier. Pay in USDC with x402, no signup. Free trial.

## Output

A JSON object containing the query parameters echoed back, a count of results, and an array of matching businesses each with name, phone, address, website, distance in km, a confidence score (0-1), and the data source attribution (e.g. Overture Maps Places).

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "category"
     ],
     "properties": {
      "lat": {
       "type": "number"
      },
      "lon": {
       "type": "number"
      },
      "limit": {
       "type": "number",
       "description": "1 to 50, default 20"
      },
      "place": {
       "type": "string",
       "description": "US city and state, or ZIP (or give lat and lon)"
      },
      "category": {
       "enum": [
        "dentist",
        "clinic",
        "veterinary",
        "pharmacy",
        "property_management",
        "estate_agent",
        "lawyer",
        "accountant",
        "insurance",
        "office",
        "coworking",
        "restaurant",
        "cafe",
        "bar",
        "hotel",
        "gym",
        "salon",
        "beauty",
        "retail",
        "car_repair",
        "school",
        "childcare",
        "senior_living",
        "worship",
        "builder",
        "trades",
        "event_venue",
        "photographer",
        "nonprofit"
       ],
       "type": "string"
      },
      "radius_km": {
       "type": "number",
       "description": "0.5 to 10, default 5"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 2,
  "query": {
   "place": "Austin, TX",
   "category": "dentist",
   "radius_km": 5
  },
  "businesses": [
   {
    "name": "Treaty Oak Dental",
    "phone": "+1 512 555 0100",
    "address": "1 Main St, Austin, TX 78701",
    "sources": {
     "datasets": [
      "meta"
     ],
     "provider": "Overture Maps Places"
    },
    "website": "https://treatyoakdental.com",
    "confidence": 0.9,
    "distance_km": 0.4
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/selfoperate-nearby-businesses-f5dfe169/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.selfoperate.com](https://www.zero.xyz/host/tools.selfoperate.com/llms.txt)
