# Yelp reviews

Needs place id. Served by Litescrape.

Get reviews for a Yelp business.

- Tool ID: `litescrape/yelp-reviews`
- Name in the catalog: Yelp Reviews
- Provider: [Litescrape](/providers/litescrape.md)
- Capability: [Reviews](/tools/reviews.md)
- Price: $0.00015 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.00015
}
```

Pricing source: [https://litescrape.com/pricing](https://litescrape.com/pricing). $0.15 per 1,000 successful HTTP 200 requests; every native endpoint costs one call. Failed requests are not billed. Prepaid credits expire after six months..

Price verification date: 2026-11-03.

## Complete input schema


```json
{
  "additionalProperties": false,
  "properties": {
    "place_id": {
      "type": "string",
      "description": "Required encoded Yelp business identifier.",
      "minLength": 1
    },
    "yelp_domain": {
      "default": "www.yelp.com",
      "type": "string",
      "description": "Supported localized Yelp hostname."
    },
    "hl": {
      "default": "en",
      "type": "string",
      "description": "Review language such as en or fr-FR."
    },
    "q": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Search review text for these terms."
    },
    "sortby": {
      "default": "relevance_desc",
      "enum": [
        "relevance_desc",
        "date_desc",
        "date_asc",
        "rating_desc",
        "rating_asc",
        "elites_desc"
      ],
      "type": "string",
      "description": "Yelp review ordering."
    },
    "rating": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Comma-separated ratings from 1 through 5."
    },
    "not_recommended": {
      "default": false,
      "type": "boolean",
      "description": "Fetch reviews that Yelp does not recommend."
    },
    "not_recommended_start": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "Offset within not-recommended reviews. Requires not_recommended=true."
    },
    "start": {
      "default": 0,
      "type": "integer",
      "description": "Review offset from 0 through 10,000."
    },
    "num": {
      "default": 49,
      "type": "integer",
      "description": "Review count from 1 through 49."
    }
  },
  "required": [
    "place_id"
  ],
  "type": "object"
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "litescrape/yelp-reviews",
  "input": {
    "place_id": "dDz2erKJ_Z2HMur0tQ_iJA"
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://litescrape.com/docs/reference#yelp-reviews-parameters)

[REST inspection](https://api.agentik.cc/v1/tools/litescrape/yelp-reviews) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/litescrape/yelp-reviews) · [Agent index](/llms.txt)