# Yelp API guide



## Choose a Yelp operation



Start with the object your task needs. The groups below use the current catalogue; open an endpoint to check accepted identifiers, filters, price and availability before retrieving.



### Other operations



- [Yelp business](https://www.monocrawl.com/docs/endpoints/yelp/business) — One Yelp business record.

- [Yelp business menu](https://www.monocrawl.com/docs/endpoints/yelp/menu) — The menu of a Yelp business in sections with prices, when one is published.

- [Yelp business photos](https://www.monocrawl.com/docs/endpoints/yelp/photos) — Photos and videos of a Yelp business, twenty per page, with the category counts.

- [Yelp related businesses](https://www.monocrawl.com/docs/endpoints/yelp/related) — Businesses the platform recommends alongside one business.



### Reviews and offers



- [Yelp business reviews](https://www.monocrawl.com/docs/endpoints/yelp/reviews) — Reviews of a Yelp business, ten per page, with the author profile, votes, photos and any owner reply.



### Search and discovery



- [Yelp business search](https://www.monocrawl.com/docs/endpoints/yelp/search) — Businesses matching a query near a place, twenty per page, with rating, review count, price range, contact details and coordinates.

- [Yelp search suggestions (businesses)](https://www.monocrawl.com/docs/endpoints/yelp/search-suggestions) — PARTIAL: business suggestions for a typed query near a place (name, id, URL, rating, address), from the held listing's search. The platform's own typeahead rows for categories, common terms and chains are not served; the answer lists what is missing.



## Check fields and collection limits



Use the endpoint’s declared parameters and returned continuation. Filters from another platform do not automatically apply here. Preserve source identifiers, URLs and warnings; a successful page does not establish complete history. Published response schemas identify whether they come from a reviewed shaper or observed response shapes.



Agents can use `get_endpoint` for the current contract and `get_docs` with topic `platforms/yelp` to read this page. The [coverage guide](https://www.monocrawl.com/docs/data-availability) explains nulls and partial results, and the [production guide](https://www.monocrawl.com/docs/production-checklist) covers budgets and recovery.



## Endpoint reference

## yelp/business

`GET /v1/yelp/business`

One Yelp business record.

*Yelp business*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Business id or alias, or its yelp.com URL — e.g. `the-old-fashioned-madison` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/yelp/business?id=the-old-fashioned-madison" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "address": "example",
  "alias": "example",
  "categories": [
    "example"
  ],
  "city": "example",
  "closed": false,
  "id": "example",
  "images": [
    "example"
  ],
  "latitude": 0,
  "longitude": 0,
  "name": "example",
  "neighborhoods": [
    "example"
  ],
  "phone": "example",
  "photo_count": 0,
  "platform": "example",
  "postal_code": "example",
  "price_range": "example",
  "rating": {
    "max": 0,
    "value": 0,
    "votes": 0
  },
  "reviews_count": 0,
  "state": "example",
  "temporarily_closed": false,
  "timezone": "example",
  "type": "example",
  "url": "https://example.com/example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/yelp/business#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/yelp/business.json)


## yelp/menu

`GET /v1/yelp/menu`

The menu of a Yelp business in sections with prices, when one is published.

*Yelp business menu*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Business id or alias — e.g. `RJNAeNA-209sctUO0dmwuA` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/yelp/menu?id=RJNAeNA-209sctUO0dmwuA" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "availability": "example",
  "business_id": "example",
  "menus": [
    {
      "description": "example",
      "hours": [
        {}
      ],
      "name": "example",
      "sections": [
        {}
      ]
    }
  ],
  "source": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/yelp/menu#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/yelp/menu.json)


## yelp/photos

`GET /v1/yelp/photos`

Photos and videos of a Yelp business, twenty per page, with the category counts.

*Yelp business photos*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Business id or alias — e.g. `RJNAeNA-209sctUO0dmwuA` |
| `category` | no | Media category slug (food, drink, menu, ...) — e.g. `food` |
| `page` | no | Page number (20 per page) — e.g. `1` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/yelp/photos?id=RJNAeNA-209sctUO0dmwuA" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "business_id": "example",
  "categories": [
    {
      "count": 0,
      "name": "example",
      "slug": "example"
    }
  ],
  "category": "example",
  "count": 0,
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "author": {
        "elite_year": 0,
        "friends": 0,
        "id": "example",
        "image": "https://example.com/example",
        "name": "example",
        "photos": 0,
        "reviews": 0
      },
      "caption": "example",
      "duration": 0,
      "height": 0,
      "id": "example",
      "posted_at": "2026-09-01T12:00:00Z",
      "share_url": "https://example.com/example",
      "thumbnail_url": "https://example.com/example",
      "type": "example",
      "url": "https://example.com/example",
      "video_url": "https://example.com/example",
      "width": 0
    }
  ],
  "page": 0,
  "total": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/yelp/photos#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/yelp/photos.json)


## yelp/related

`GET /v1/yelp/related`

Businesses the platform recommends alongside one business.

*Yelp related businesses*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Business id or alias — e.g. `RJNAeNA-209sctUO0dmwuA` |
| `limit` | no | Up to 20 — e.g. `10` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/yelp/related?id=RJNAeNA-209sctUO0dmwuA" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "business_id": "example",
  "count": 0,
  "has_more": false,
  "items": [
    {
      "address": "example",
      "alias": "example",
      "categories": [
        "example"
      ],
      "city": "example",
      "id": "example",
      "images": [
        "example"
      ],
      "latitude": 0,
      "longitude": 0,
      "name": "example",
      "neighborhoods": [],
      "phone": "example",
      "platform": "example",
      "price_range": "example",
      "rating": {
        "max": 0,
        "value": 0,
        "votes": 0
      },
      "reviews_count": 0,
      "state": "example",
      "type": "example",
      "url": "https://example.com/example",
      "website": "example"
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/yelp/related#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/yelp/related.json)


## yelp/reviews

`GET /v1/yelp/reviews`

Reviews of a Yelp business, ten per page, with the author profile, votes, photos and any owner reply.

*Yelp business reviews*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Business id or alias, or its yelp.com URL — e.g. `RJNAeNA-209sctUO0dmwuA` |
| `page` | no | Page number (10 per page) — e.g. `1` |
| `sort` | no | yelp (default) or newest Accepted values: yelp, newest. Case, spaces, hyphens and underscores are interchangeable. — e.g. `newest` |
| `keywords` | no | Only reviews mentioning this text |
| `language` | no | ISO 639-1 language — e.g. `en` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `sort`: Choose the documented source ordering before paging through results. Ordering keeps the normal endpoint price and does not guarantee exhaustive results.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 3 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/yelp/reviews?id=RJNAeNA-209sctUO0dmwuA" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "business_id": "example",
  "count": 0,
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "author": {
        "elite_year": 0,
        "friends": 0,
        "id": "example",
        "image": "https://example.com/example",
        "location": "example",
        "name": "example",
        "photos": 0,
        "reviews": 0,
        "url": "https://example.com/example"
      },
      "id": "example",
      "images": [
        {}
      ],
      "language": "example",
      "platform": "example",
      "posted_at": "2026-09-01T12:00:00Z",
      "rating": 0,
      "text": "example",
      "url": "https://example.com/example",
      "votes": {
        "cool": 0,
        "funny": 0,
        "useful": 0
      }
    }
  ],
  "languages": {
    "en": 0,
    "es": 0,
    "fr": 0,
    "zh": 0
  },
  "page": 0,
  "total": 0,
  "total_pages": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/yelp/reviews#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/yelp/reviews.json)


## yelp/search

`GET /v1/yelp/search`

Businesses matching a query near a place, twenty per page, with rating, review count, price range, contact details and coordinates.

*Yelp business search*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | What to look for — e.g. `Cheese Curds` |
| `location` | yes | City, address or postcode — e.g. `Madison, WI` |
| `page` | no | Page number (20 per page) — e.g. `1` |
| `sort` | no | Result ordering — e.g. `recommended` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `sort`: Choose the documented source ordering before paging through results. Ordering keeps the normal endpoint price and does not guarantee exhaustive results.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/yelp/search?query=Cheese%20Curds&location=Madison%2C%20WI" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "address": "example",
      "alias": "example",
      "categories": [
        "example"
      ],
      "city": "example",
      "id": "example",
      "images": [
        "example"
      ],
      "latitude": 0,
      "longitude": 0,
      "name": "example",
      "neighborhoods": [],
      "phone": "example",
      "platform": "example",
      "postal_code": "example",
      "price_range": "example",
      "rating": {
        "max": 0,
        "value": 0,
        "votes": 0
      },
      "reviews_count": 0,
      "state": "example",
      "type": "example",
      "url": "https://example.com/example"
    }
  ],
  "location": "example",
  "page": 0,
  "query": "example",
  "total": 0,
  "total_pages": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/yelp/search#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/yelp/search.json)


## yelp/search-suggestions

`GET /v1/yelp/search-suggestions`

PARTIAL: business suggestions for a typed query near a place (name, id, URL, rating, address), from the held listing's search. The platform's own typeahead rows for categories, common terms and chains are not served; the answer lists what is missing.

*Yelp search suggestions (businesses)*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search words as typed — e.g. `pizza` |
| `location` | yes | City, address or postcode — e.g. `New York, NY` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/yelp/search-suggestions?query=pizza&location=New%20York%2C%20NY" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "_warnings": [
    "example"
  ],
  "count": 0,
  "has_more": false,
  "items": [
    {
      "alias": "example",
      "id": "example",
      "price_range": "example",
      "rating": {
        "max": 0,
        "value": 0,
        "votes": 0
      },
      "reviews_count": 0,
      "subtitle": "example",
      "title": "example",
      "type": "example",
      "url": "https://example.com/example"
    }
  ],
  "location": "example",
  "note": "example",
  "partial": false,
  "query": "example",
  "row_types_missing": [
    "example"
  ],
  "row_types_served": [
    "example"
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/yelp/search-suggestions#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/yelp/search-suggestions.json)