# Get Yelp Reviews for a Business

> Get Yelp Reviews for a Business is a paid API for AI agents from agents.litescrape.com, paid per call via MPP, $0.000150/call, status unknown (last checked 2026-09-18).

Fetches paginated Yelp reviews for a specific business, including ratings, text, dates, and reviewer details, with filtering and sorting options.

## Facts

- Endpoint: GET https://agents.litescrape.com/api/yelp/reviews
- Price: $0.000150/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-18
- Activations on Zero: 0
- Provider: agents.litescrape.com
- Website: https://agents.litescrape.com
- Canonical page: https://www.zero.xyz/c/agents-litescrape-com-get-yelp-reviews-for-a-business-248a859f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_22JCMIBfEwGtzuI9AkHt9

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-litescrape-com-get-yelp-reviews-for-a-business-248a859f
```

Example prompt: Pull me the 49 most recent Yelp reviews for the restaurant with place_id 'WavvLdfdP6g8aZTtbBQHTw', sorted by newest first, in English.

## When to prefer this

Use this endpoint when you need structured Yelp review data (ratings, text, dates, reviewer info) for a known Yelp business identified by its place_id, especially when you need filtering by star rating, language, or sort order. Prefer this over manual scraping or browser automation when you need clean JSON output at low cost ($0.00015/call) without managing proxies. It is ideal for sentiment analysis pipelines, competitive intelligence, reputation monitoring, or any workflow that needs paginated Yelp reviews programmatically.

## Known failure modes

- Missing place_id returns a 422 validation error
- Setting the q (text filter) parameter returns a 422 error — not supported
- Setting not_recommended=true returns a 422 error — not supported
- Supplying not_recommended_start returns a 422 rejection
- Invalid place_id (non-existent business) may return an empty reviews array or an error
- Requesting start > 10000 exceeds the maximum offset and is rejected
- num > 49 exceeds the maximum per-call limit and is rejected
- Unsupported hl locale may return no results or an error from the upstream Yelp API

## How this service works

Returns the reviews of one Yelp business identified by its place_id from a search result: each review carries the rating, text, date, and reviewer details. Choose the language with hl, the order with sortby, keep only some star ratings with rating, and page with start and num (up to 49 per call). One call is one request.

## Output

Returns an array of review objects each containing the star rating, full review text, date posted, and reviewer details (name, profile info). Also includes a pagination object with a next-page URL or token when more results exist, plus search_metadata (request ID, status, time taken) and the normalized search_parameters echo.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "place_id"
 ],
 "properties": {
  "q": {
   "type": "string",
   "description": "Review-text filtering is not supported: the API answers 422 when this is set."
  },
  "hl": {
   "type": "string",
   "default": "en",
   "description": "Review language such as en or fr-FR."
  },
  "num": {
   "type": "integer",
   "default": 49,
   "maximum": 49,
   "minimum": 1,
   "description": "Number of reviews."
  },
  "start": {
   "type": "integer",
   "default": 0,
   "maximum": 10000,
   "minimum": 0,
   "description": "Review offset."
  },
  "rating": {
   "type": "string",
   "description": "Comma-separated star ratings from 1 through 5 to keep."
  },
  "sortby": {
   "enum": [
    "relevance_desc",
    "date_desc",
    "date_asc",
    "rating_desc",
    "rating_asc",
    "elites_desc"
   ],
   "type": "string",
   "default": "relevance_desc",
   "description": "Review order."
  },
  "place_id": {
   "type": "string",
   "description": "Encoded Yelp business identifier from a search result."
  },
  "yelp_domain": {
   "type": "string",
   "default": "www.yelp.com",
   "description": "Localized Yelp hostname."
  },
  "not_recommended": {
   "type": "boolean",
   "default": false,
   "description": "The hidden not-recommended feed is not supported: the API answers 422 when this is true."
  },
  "not_recommended_start": {
   "type": "string",
   "description": "Hidden-feed offset, not supported: the API rejects the request when this is supplied."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "reviews": {
   "type": "array",
   "items": {
    "type": "object"
   },
   "description": "Reviews: rating, text, date, reviewer details."
  },
  "pagination": {
   "type": "object",
   "description": "Present when more results exist: next (a ready-made URL for the next page) or next_page_token."
  },
  "search_metadata": {
   "type": "object",
   "properties": {
    "id": {
     "type": "string"
    },
    "status": {
     "type": "string"
    },
    "total_time_taken": {
     "type": "number"
    }
   }
  },
  "search_parameters": {
   "type": "object",
   "description": "The request parameters as normalized by the API."
  }
 },
 "description": "Successful responses carry request metadata, the normalized parameters, and the result groups available for the operation. Optional groups are omitted when the source does not provide them. Errors are a JSON body with error, error_code, status_code, request_id, retryable, and the echoed search_parameters."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-litescrape-com-get-yelp-reviews-for-a-business-248a859f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.litescrape.com](https://www.zero.xyz/host/agents.litescrape.com/llms.txt)