# Yelp Business Details

> Yelp Business Details 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 detailed business information for one or up to 20 Yelp businesses by business ID or alias, including ratings, contact info, owner details, and menu links.

## Facts

- Endpoint: GET https://agents.openwebninja.com/yelp-business-data/business-details?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-details-867428ed
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-m20xdyXMojlnKwSjKEg2

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-details-867428ed
```

Example prompt: Can you pull up the full Yelp details for 'gary-danko-san-francisco' — I want their phone number, address, rating, price range, and a link to their menu?

## When to prefer this

Use this endpoint when you need structured Yelp-specific business details — especially owner info, Yelp ratings, menu links, or price ranges — and you already have a Yelp business ID or alias. It supports batching up to 20 businesses per call, making it efficient for bulk enrichment workflows. Prefer this over Google Maps endpoints when the user specifically references Yelp or when Yelp ratings/reviews are the primary data need.

## Known failure modes

- Invalid or non-existent business ID returns empty data array
- Exceeding 20 business IDs in a single batch may result in an error
- Rate limiting or quota exhaustion returns a 402 or 429 error
- Unsupported yelp_domain enum value causes a validation error
- Business may have incomplete data (e.g. no menu URL or owner info) if not provided on Yelp

## How this service works

Fetch a single or multiple business details from Yelp.

## Output

Returns an array of business objects, each containing the business ID, name, alias, phone number, address, country, website URL, menu URL, Yelp menu URL, business photo URL, rating, review count, price range, owner name, owner biography, owner photo URL, and a direct link to the Yelp business page. Also includes a response status and request ID.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "business_id"
 ],
 "properties": {
  "business_id": {
   "type": "string",
   "description": "Yelp business id or alias to fetch details for.  \n  In addition, batching of up to 20 Business Ids or aliases is supported in a single request using a comma separated list (e.g. business_id=id1,id2)."
  },
  "yelp_domain": {
   "enum": [
    "yelp.com",
    "yelp.com.au",
    "yelp.co.nz",
    "ms.yelp.my",
    "yelp.cz",
    "yelp.dk",
    "yelp.de",
    "yelp.at",
    "de.yelp.ch",
    "en.yelp.be",
    "yelp.ca",
    "en.yelp.com.hk",
    "en.yelp.my",
    "en.yelp.com.ph",
    "yelp.ie",
    "yelp.com.sg",
    "en.yelp.ch",
    "yelp.co.uk",
    "yelp.com.ar",
    "yelp.cl",
    "yelp.es",
    "yelp.com.mx",
    "fil.yelp.com.ph",
    "yelp.fr",
    "fr.yelp.ca",
    "fr.yelp.ch",
    "fr.yelp.be",
    "yelp.no",
    "yelp.pl",
    "yelp.pot",
    "yelp.com.br",
    "fi.yelp.fi",
    "sv.yelp.fi",
    "yelp.se",
    "yelp.com.tr",
    "yelp.co.jp",
    "zh.yelp.com.hk",
    "yelp.com.tw"
   ],
   "type": "string",
   "default": "yelp.com",
   "description": "The yelp domain to use for the search."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "description": "The unique identifier of the business"
     },
     "name": {
      "type": "string",
      "description": "The name of the business"
     },
     "alias": {
      "type": "string",
      "description": "The alias of the business"
     },
     "phone": {
      "type": "string",
      "description": "The phone number of the business"
     },
     "photo": {
      "type": "string",
      "description": "The URL of the business photo"
     },
     "rating": {
      "type": "number",
      "description": "The rating of the business"
     },
     "address": {
      "type": "string",
      "description": "The address of the business"
     },
     "country": {
      "type": "string",
      "description": "The country where the business is located"
     },
     "website": {
      "type": "string",
      "description": "The website URL of the business"
     },
     "menu_url": {
      "type": "string",
      "description": "The URL of the business menu"
     },
     "yelp_menu": {
      "type": "string",
      "description": "The URL to the Yelp menu of the business"
     },
     "owner_name": {
      "type": "string",
      "description": "The name of the business owner"
     },
     "price_range": {
      "type": "string",
      "description": "The price range of the business"
     },
     "review_count": {
      "type": "integer",
      "description": "The number of reviews for the business"
     },
     "owner_biography": {
      "type": "string",
      "description": "A short biography of the business owner"
     },
     "owner_photo_url": {
      "type": "string",
      "description": "The URL of the business owner's photo"
     },
     "business_page_link": {
      "type": "string",
      "description": "The link to the business page"
     }
    }
   }
  },
  "status": {
   "type": "string",
   "description": "The status of the response"
  },
  "request_id": {
   "type": "string",
   "description": "The unique identifier for the request"
  }
 }
}
```

## More

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