# serp402 Yelp Reviews API

> serp402 Yelp Reviews API is a paid API for AI agents from serp402.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-31).

Fetches structured Yelp reviews for a given place, including user info, ratings, dates, comments, and owner responses

## Facts

- Endpoint: POST https://serp402.com/api/v1/yelp-reviews?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/serp402-yelp-reviews-api-dbba7307
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JRco0oOCow9InjD7ob2ke

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 serp402-yelp-reviews-api-dbba7307 -d '<json body>'
```

Example prompt: Pull the 49 most recent Yelp reviews for the restaurant with Yelp ID 'ED7A7vDdg8yLNKJTSVHHmg', sorted by newest first, in English — I want the reviewer names, ratings, dates, comments, and any owner responses.

## When to prefer this

Choose this endpoint when you need structured Yelp review data without managing a Yelp API key or subscription, especially for ad-hoc lookups, competitive research, or reputation monitoring. It supports filtering by rating and fetching not-recommended reviews that Yelp hides by default — useful for deeper sentiment analysis. It is pay-per-call at $0.05 USDC with no minimums, making it ideal for low-volume or one-off agent tasks.

## Known failure modes

- Invalid or unsupported place_id returns empty results or error
- place_id of second format (slug-style) not supported — only alphanumeric IDs work
- Requesting more than 49 results per call is not supported
- Unsupported Yelp domain may return no results
- Payment failure (insufficient USDC balance) blocks the call
- Yelp rate limiting or blocking on the scraping side may cause intermittent failures

## How this service works

Yelp Reviews: User information, rating, date, comment, owner responses and more. Structured JSON, USD 0.05 per call in USDC — no API key, no account, no subscription, no minimum. Not affiliated with, endorsed by or an official channel of any of the services the results come from. All trademarks and copyright remain the property of their respective owners.

## Output

Returns a structured JSON array of Yelp reviews for the requested business, each containing reviewer username, profile details, star rating, review date, full review text, owner response (if any), and recommendation status. Supports up to 49 results per call with pagination.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "hl": {
   "type": "string",
   "description": "language to use for sorting Yelp Reviews. It's a two-letter language code. (e.g., en for English, es for Spanish, or fr for French) Head to the Yelp Reviews…"
  },
  "num": {
   "type": "string",
   "description": "maximum number of results to return. 49 (default) returns 49 results. Maximum number of results to return is 49 ."
  },
  "start": {
   "type": "string",
   "description": "result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 49 is the 2nd page of results,…"
  },
  "rating": {
   "type": "string",
   "description": "Parameter filters out the results by rating. Possible values are 5 , 4 , 3 , 2 , and 1 . All results are included by default. To only show results with the…"
  },
  "sortby": {
   "type": "string",
   "description": "Parameter is used for sorting results. Available options: relevance_desc - Yelp Sort (default) date_desc - Newest First date_asc - Oldest Rated rating_desc -…"
  },
  "place_id": {
   "type": "string",
   "description": "Yelp ID of a place. Each place has two unique IDs (e.g. ED7A7vDdg8yLNKJTSVHHmg and arabica-brooklyn ). Only the first ID type is supported (e.g.…"
  },
  "yelp_domain": {
   "type": "string",
   "description": "Yelp domain to use. It defaults to yelp.com . Head to the Yelp domains for a full list of supported Yelp domains."
  },
  "not_recommended": {
   "type": "string",
   "description": "Parameter fetches reviews that are not recommended by Yelp. It can be set to true to only show not recommended reviews, or false to show recommended reviews.…"
  },
  "not_recommended_start": {
   "type": "string",
   "description": "result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 10 is the 2nd page of results,…"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/serp402-yelp-reviews-api-dbba7307/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from serp402.com](https://www.zero.xyz/host/serp402.com/llms.txt)