# Yelp Business Search

> Yelp Business Search is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Search Yelp for businesses matching a keyword query and location, returning listings with ratings, reviews, contact info, and categories.

## Facts

- Endpoint: GET https://agents.openwebninja.com/yelp-business-data/business-search?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-yelp-business-search-1408e841
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GlKYYamxeR45zaPc4jhre

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 agents-openwebninja-com-yelp-business-search-1408e841
```

Example prompt: Can you search Yelp for the top-rated Italian restaurants in Boston, sorted by highest rating, in the $$ to $$$ price range?

## When to prefer this

Choose this endpoint when you need Yelp-specific business data including Yelp ratings, review counts, Yelp categories, and price range indicators for a keyword search across a named location. It is particularly valuable when the user explicitly wants Yelp results, needs international Yelp domain coverage, or requires pagination through large result sets. Prefer this over Google Maps search endpoints when Yelp's review ecosystem and category taxonomy are specifically needed.

## Known failure modes

- Missing required 'query' or 'location' parameters returns a validation error
- Invalid price_range values (not $, $$, $$$, $$$$) may return no results or an error
- Unsupported yelp_domain enum value causes a request error
- Very broad or misspelled queries may return empty result arrays
- Rate limiting or payment issues return 402/429 errors from the proxy layer
- Location strings that Yelp cannot geocode return empty results

## How this service works

Search for Yelp businesses by query / keyword and location.

## Output

Returns an array of Yelp business objects, each containing a unique business ID, alias, name, business page link, phone number, lead photo URL, average rating (0–5), review count, price range indicator ($–$$$$), business categories with URLs, geographic coordinates, country code, website URL, neighborhood labels, and Yelp-guaranteed status. Supports pagination via the start offset parameter.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query",
  "location"
 ],
 "properties": {
  "query": {
   "type": "string",
   "description": "Search query / keyword"
  },
  "start": {
   "type": "integer",
   "default": 0,
   "description": "Number of results to skip. Mainly used for pagination."
  },
  "sort_by": {
   "enum": [
    "RECOMMENDED",
    "HIGHEST_RATED",
    "REVIEW_COUNT"
   ],
   "type": "string",
   "default": "RECOMMENDED",
   "description": "Return the results in a specific sort order."
  },
  "location": {
   "type": "string",
   "description": "Search location."
  },
  "price_range": {
   "type": "string",
   "description": "Find business with specific price ranges, specified as a comma delimited list of the following values: $, $$, $$$, $$$$."
  },
  "yelp_domain": {
   "enum": [
    "yelp.com",
    "yelp.com.au",
    "yelp.co.nz",
    "ms.yelp.my",
    "yelp.cz",
    "yelp.dk",
    "yelp.de",
    "yelp.at",
    "de.yelp.ch",
    "en.yelp.be",
    "yelp.ca",
    "en.yelp.com.hk",
    "en.yelp.my",
    "en.yelp.com.ph",
    "yelp.ie",
    "yelp.com.sg",
    "en.yelp.ch",
    "yelp.co.uk",
    "yelp.com.ar",
    "yelp.cl",
    "yelp.es",
    "yelp.com.mx",
    "fil.yelp.com.ph",
    "yelp.fr",
    "fr.yelp.ca",
    "fr.yelp.ch",
    "fr.yelp.be",
    "yelp.no",
    "yelp.pl",
    "yelp.pot",
    "yelp.com.br",
    "fi.yelp.fi",
    "sv.yelp.fi",
    "yelp.se",
    "yelp.com.tr",
    "yelp.co.jp",
    "zh.yelp.com.hk",
    "yelp.com.tw"
   ],
   "type": "string",
   "default": "yelp.com",
   "description": "The yelp domain to use for the search."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "alias",
     "name",
     "business_page_link"
    ],
    "properties": {
     "id": {
      "type": "string",
      "description": "Unique Yelp business ID."
     },
     "name": {
      "type": "string",
      "description": "Business name."
     },
     "tags": {
      "type": "array",
      "items": {
       "type": "string",
       "description": "A single Yelp tag."
      },
      "nullable": true,
      "description": "Additional Yelp tags for the business (e.g. waitlist info)."
     },
     "alias": {
      "type": "string",
      "description": "Human-readable Yelp business alias (used in URLs)."
     },
     "phone": {
      "type": "string",
      "nullable": true,
      "description": "Business phone number in E.164 format."
     },
     "photo": {
      "type": "string",
      "nullable": true,
      "description": "URL of the business's lead photo."
     },
     "rating": {
      "type": "number",
      "nullable": true,
      "description": "Average Yelp rating of the business (0-5)."
     },
     "country": {
      "type": "string",
      "nullable": true,
      "description": "ISO 3166-1 alpha-2 country code of the business."
     },
     "website": {
      "type": "string",
      "nullable": true,
      "description": "Business website URL."
     },
     "latitude": {
      "type": "number",
      "nullable": true,
      "description": "Business latitude coordinate."
     },
     "longitude": {
      "type": "number",
      "nullable": true,
      "description": "Business longitude coordinate."
     },
     "categories": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "title"
       ],
       "properties": {
        "url": {
         "type": "string",
         "nullable": true,
         "description": "URL of the Yelp category search results page."
        },
        "title": {
         "type": "string",
         "description": "Category label."
        }
       }
      },
      "nullable": true,
      "description": "Yelp categories the business belongs to."
     },
     "price_range": {
      "type": "string",
      "nullable": true,
      "description": "Yelp price range indicator. Values: $, $$, $$$, $$$$."
     },
     "review_count": {
      "type": "integer",
      "nullable": true,
      "description": "Total number of Yelp reviews for the busin
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-yelp-business-search-1408e841/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)