# Yelp Business Search via OpenWebNinja

> Yelp Business Search via OpenWebNinja is a paid API for AI agents from openwebninja-x402.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-30).

Search Yelp for businesses matching a keyword query and location, with optional filters for sort order and price range.

## Facts

- Endpoint: GET https://openwebninja-x402.vercel.app/api/yelp/business-search?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yelp-business-search-via-openwebninja-0e415f53
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UmHuSK9XNCh13GaJNgD97

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 yelp-business-search-via-openwebninja-0e415f53
```

Example prompt: Can you search Yelp for the highest-rated sushi restaurants in San Francisco, sorted by rating, and show me only mid-range price options?

## When to prefer this

Use this endpoint when you need to search Yelp's business directory by keyword and location and want structured results including ratings, reviews, and price ranges. Prefer this over generic web search when you specifically need Yelp data with filtering by price and sort order. Pair with the sibling Yelp business profile endpoint to get detailed info on a specific business after discovering it here.

## Known failure modes

- Missing required 'query' parameter returns validation error
- Missing required 'location' parameter returns validation error
- Invalid sort_by value (not one of RECOMMENDED, HIGHEST_RATED, REVIEW_COUNT) causes error
- No results found for obscure query/location combinations
- Payment failure (402) if USDC balance is insufficient
- Rate limiting or upstream Yelp API errors causing 5xx responses

## How this service works

Search Yelp businesses by query and location.

## Output

A list of Yelp business results matching the query and location, including business names, ratings, review counts, addresses, price levels, and other profile details from Yelp's directory.

## 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",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "query",
      "location"
     ],
     "properties": {
      "query": {
       "type": "string",
       "minLength": 1
      },
      "start": {
       "type": "integer",
       "maximum": 9007199254740991,
       "minimum": 0
      },
      "sort_by": {
       "enum": [
        "RECOMMENDED",
        "HIGHEST_RATED",
        "REVIEW_COUNT"
       ],
       "type": "string"
      },
      "location": {
       "type": "string",
       "minLength": 1
      },
      "price_range": {
       "type": "string",
       "minLength": 1
      },
      "yelp_domain": {
       "type": "string",
       "minLength": 1
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yelp-business-search-via-openwebninja-0e415f53/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from openwebninja-x402.vercel.app](https://www.zero.xyz/host/openwebninja-x402.vercel.app/llms.txt)