# OneShotAgent Local Business Search

> OneShotAgent Local Business Search is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Search for local businesses by category and location, returning filtered, rated results for restaurants, contractors, medical practices, and more.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/local/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshotagent-local-business-search-88c0a968
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xhfJFquhcHsmMHbl0ovCw

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 oneshotagent-local-business-search-88c0a968 -d '<json body>'
```

Example prompt: Can you find me the top 10 open Italian restaurants in Austin, TX with at least a 4-star rating and 50 reviews, excluding chains?

## When to prefer this

Use this endpoint when you need structured local business data filtered by category, geography, rating, or chain status — especially for lead generation, market research, or building location-aware recommendations. Prefer this over generic web search when you need clean, filterable records with review metadata rather than raw web pages.

## Known failure modes

- No results returned if category or location is too narrow or misspelled
- Operating status filter may exclude recently closed businesses not yet updated in the dataset
- Chain detection may misclassify some independent businesses
- Domains marked as resolvable may occasionally be stale or broken
- Rate or review count filters may dramatically reduce result set for less-populated areas

## How this service works

Local business discovery by category and location (restaurants, contractors, practices). Flat price per search.

## Output

Returns a list of local business records matching the search criteria, including business name, address, category, star rating, review count, website domain (if available), chain status, and operating status — up to the specified limit (max 500).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "description": "Max results (1-500, default 100)"
  },
  "category": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Business categories (e.g. \"hvac contractor\", \"dental practice\")"
  },
  "is_chain": {
   "type": "boolean",
   "description": "true = only chains, false = exclude detected chains"
  },
  "keywords": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Free-text keywords (alternative to category)"
  },
  "location": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Cities, neighborhoods, or \"City, ST\" strings"
  },
  "has_domain": {
   "type": "boolean",
   "description": "true = only rows with a resolvable website domain"
  },
  "min_rating": {
   "type": "number",
   "description": "Minimum star rating (0-5)"
  },
  "min_review_count": {
   "type": "number",
   "description": "Minimum review count"
  },
  "operating_status": {
   "enum": [
    "open",
    "any"
   ],
   "type": "string",
   "description": "Default \"open\" drops closed businesses"
  }
 }
}
```

## More

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