# serp402 Yelp Search Scraper

> serp402 Yelp Search Scraper 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).

Scrapes Yelp search results and returns structured JSON including business position, title, link, rating, review count, and more

## Facts

- Endpoint: POST https://serp402.com/api/v1/yelp-search?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-search-scraper-998a5925
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4HiqH7U-2UE5IDDO2Qmm4

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-search-scraper-998a5925 -d '<json body>'
```

Example prompt: Search Yelp for the best-rated Italian restaurants in Chicago, sorted by highest rated, and give me the first page of results with names, ratings, and review counts.

## When to prefer this

Choose this endpoint when you need to programmatically query Yelp search results without a Yelp API key or account, especially for local business discovery, competitor research, or aggregating ratings and reviews. It is ideal for agents that need pay-per-call access with no subscription commitment and support for pagination, category filtering, and sort ordering.

## Known failure modes

- Invalid or unrecognized location returns empty results or error
- Yelp blocking or rate-limiting the scraper causes failed or incomplete responses
- Unsupported Yelp domain returns an error
- Invalid sort-by value causes parameter rejection
- Pagination offset beyond available results returns empty array
- Payment not confirmed results in request rejection

## How this service works

Yelp: Scrape Yelp search results in JSON format automatically using custom parameters. Position, title, link, rating, reviews and more available. 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 business listings from the search results page, including each business's position in results, name, Yelp URL, star rating, review count, category, and any other metadata Yelp surfaces such as price range or featured attributes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cflt": {
   "type": "string",
   "description": "a category. It can be used alongside find_desc parameter to refine the search."
  },
  "attrs": {
   "type": "string",
   "description": "Parameter is used for refining results. You can add more filters like 'price', 'features', etc. to your search. You can use our JSON endpoint to fetch values.…"
  },
  "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,…"
  },
  "sortby": {
   "type": "string",
   "description": "Parameter is used for sorting results. Available options: recommended - Recommended (default) rating - Highest Rated review_count - Most Reviewed"
  },
  "find_loc": {
   "type": "string",
   "description": "from where you want the search to originate. You can use any location you would use in a regular Yelp search. Following location formats are acceptable: - 706…"
  },
  "find_desc": {
   "type": "string",
   "description": "query you want to search. You can use anything that you would use in a regular Yelp search."
  },
  "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."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/serp402-yelp-search-scraper-998a5925/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)