# Yelp Business Reviews

> Yelp Business Reviews 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).

Fetch paginated customer reviews for a specific Yelp business, with filtering by language, sort order, and text query.

## Facts

- Endpoint: GET https://agents.openwebninja.com/yelp-business-data/business-reviews?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-reviews-ecc62d6a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0wmmH1_SBYAyUlw70K_em

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-reviews-ecc62d6a
```

Example prompt: Pull me the top 20 best-match Yelp reviews for the business with alias 'gary-danko-san-francisco' — grab 2 pages starting from page 1 and only return English reviews.

## When to prefer this

Use this endpoint when you need Yelp-specific customer reviews for a business and have a Yelp business ID or alias. It is ideal when you want to filter by review language, sort by recency, rating, or elite status, or search reviews by keyword. Prefer this over Google review endpoints when Yelp reputation data is specifically needed.

## Known failure modes

- Invalid or non-existent business_id returns an error or empty results
- Requesting num_pages outside 1-10 range returns a validation error
- Unsupported language code may return no results or an error
- ELITES sort with no elite reviews returns an empty set
- Rate limiting or payment failure returns a 402 or 429 error
- Page number beyond available pages returns empty review set

## How this service works

Fetch a single or multiple business review pages from Yelp (each page includes up to 10 reviews).

## Output

Returns a data object containing the total number of reviews, an array of reviews for the requested page(s) (up to 10 reviews per page, or up to 45 with page_size), review language breakdown with counts, a status string, and a unique request ID.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "business_id"
 ],
 "properties": {
  "page": {
   "type": "integer",
   "default": 1,
   "description": "Page to return (each page includes up to 10 results)."
  },
  "sort": {
   "enum": [
    "BEST_MATCH",
    "NEWEST",
    "OLDEST",
    "HIGHEST_RATED",
    "LOWEST_RATED",
    "ELITES"
   ],
   "type": "string",
   "default": "BEST_MATCH",
   "description": "How to sort reviews in the results. Note that the ELITES value will cause the API to only return reviews posted by elite members."
  },
  "query": {
   "type": "string",
   "description": "Return reviews matching a text query"
  },
  "language": {
   "type": "string",
   "default": "en",
   "description": "Only return reviews of a certain language.  \n For a list of supported language codes see https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2."
  },
  "num_pages": {
   "type": "integer",
   "default": 1,
   "description": "Number of pages to return, starting from page. Allowed values: 1-10.  \n\n  **Note:** requests for more than one page are charged 2x."
  },
  "page_size": {
   "type": "integer",
   "default": 10,
   "description": "Results page size. Allowed values: 1-45."
  },
  "business_id": {
   "type": "string",
   "description": "Yelp business id or alias to fetch reviews for."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "total": {
     "type": "integer",
     "description": "The total number of reviews."
    },
    "review_languages": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "count": {
        "type": "integer",
        "description": "The number of reviews in this language."
       },
       "language": {
        "type": "string",
        "description": "The language of the reviews."
       }
      }
     }
    }
   }
  },
  "status": {
   "type": "string",
   "description": "The status of the response."
  },
  "request_id": {
   "type": "string",
   "description": "A unique identifier for the request."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-yelp-business-reviews-ecc62d6a/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)