# Search Yelp Businesses

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

Searches Yelp for businesses by location and optional query terms, returning structured listings with ratings, reviews, categories, pricing, and contact info.

## Facts

- Endpoint: GET https://agents.litescrape.com/api/yelp/search
- 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-search-yelp-businesses-941e86b4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VHF5pjhxCbX-PubtPxGWW

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-search-yelp-businesses-941e86b4
```

Example prompt: Can you find me the top-rated sushi restaurants in San Francisco sorted by rating, and show me their addresses and phone numbers?

## When to prefer this

Use this endpoint when you need structured Yelp business listings — including ratings, review counts, categories, price, address, and phone — for a specific location. It is ideal when Yelp-specific data (place_ids for reviews, Yelp attributes like open_now, price filters) is required, or when you need paginated results across many businesses. Prefer it over Google Maps or other local search endpoints when Yelp's crowd-sourced review data and category taxonomy are specifically needed, or when the user explicitly references Yelp.

## Known failure modes

- Missing required find_loc parameter returns a 400 error with error_code and error message
- Invalid cflt category identifier returns empty results or an error
- Invalid attrs filter names return an error or are silently ignored
- Exceeding the start offset maximum of 10000 returns an error
- Providing an unsupported yelp_domain may return an error or unexpected results
- Rate limits or upstream Yelp availability issues return a retryable error response

## How this service works

Searches Yelp for businesses in find_loc, optionally matching find_desc terms or a cflt category, and returns organic_results (position, name, rating, review count, categories, price, address, phone, and the place_id for the reviews endpoint) with pagination. Sort with sortby, filter with Yelp attribute names in attrs, restrict to a map area with a Yelp l token, and use a localized yelp_domain for other countries. One call is one request.

## Output

Returns an array of organic_results, each containing position, business name, star rating, review count, categories, price tier, street address, phone number, and a place_id usable with the Yelp reviews endpoint. Also includes search_metadata (request ID, status, time taken), search_parameters (normalized inputs), and a pagination object with a next-page URL or token when more results are available.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "find_loc"
 ],
 "properties": {
  "l": {
   "type": "string",
   "description": "Yelp-native map bounds token."
  },
  "cflt": {
   "type": "string",
   "pattern": "^[A-Za-z0-9_-]+$",
   "description": "Yelp category identifier, such as coffee or restaurants."
  },
  "attrs": {
   "type": "string",
   "description": "Comma-separated Yelp attribute filters, such as open_now or price.1."
  },
  "start": {
   "type": "integer",
   "default": 0,
   "maximum": 10000,
   "minimum": 0,
   "description": "Result offset."
  },
  "sortby": {
   "enum": [
    "recommended",
    "rating",
    "review_count"
   ],
   "type": "string",
   "default": "recommended",
   "description": "Result order."
  },
  "find_loc": {
   "type": "string",
   "description": "Search location, such as a city or neighborhood."
  },
  "find_desc": {
   "type": "string",
   "description": "Business name, category, or search terms."
  },
  "yelp_domain": {
   "type": "string",
   "default": "www.yelp.com",
   "description": "Localized Yelp hostname, such as www.yelp.co.uk."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "pagination": {
   "type": "object",
   "description": "Present when more results exist: next (a ready-made URL for the next page) or next_page_token."
  },
  "organic_results": {
   "type": "array",
   "items": {
    "type": "object"
   },
   "description": "Businesses: position, name, rating, review count, categories, price, address, phone, place_id."
  },
  "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-search-yelp-businesses-941e86b4/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)