# OneShot Agent Business Finder

> OneShot Agent Business Finder is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-19).

Search and filter local businesses by category, location, rating, and other criteria to return a list of matching results

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/find/business?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-business-finder-e2df383e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_feOaOjnzaK0nF3VoulSh3

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 oneshot-agent-business-finder-e2df383e -d '<json body>'
```

Example prompt: Find me up to 50 open HVAC contractors in Austin, TX with at least a 4-star rating and a minimum of 25 reviews — exclude chains and only include businesses that have a website.

## When to prefer this

Use this endpoint when you need to discover multiple local businesses matching geographic and quality criteria — especially when you want to filter by category, star rating, review count, chain status, or website presence. Prefer this over general web search when you need structured, filterable business data rather than unstructured search results.

## Known failure modes

- Invalid category or keyword yields no results
- Location string not recognized returns empty result set
- Limit out of range (below 1 or above 500) may cause validation error
- min_rating above 5 or below 0 causes schema error
- Async response requires polling request_id for final results
- Payment failure via x402 prevents job from being submitted

## How this service works

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

## Output

Returns a JSON object with a status field (e.g. 'processing') and a request_id (UUID) that can be used to retrieve the list of matching businesses once the query completes.

## 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": "integer",
   "description": "Minimum review count"
  },
  "operating_status": {
   "enum": [
    "open",
    "any"
   ],
   "type": "string",
   "description": "Default \"open\" drops closed businesses"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "processing",
  "request_id": "uuid"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-business-finder-e2df383e/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)