# Negative Yelp Reviews for Complaint Analysis

**Use case:** 

Understand what drives customers away. Set Rating to 1 star and the scraper returns only 1-star reviews, each with review_text, review_date, latest_reviewer_rating, helpful_count and oh_no_count, so you can rank complaints yourself by how many people relate. This filtered subset usually ends below the cap. This demo caps Max_reviews at 100; set Max_reviews to 0 for all.

## Input

```json
{
  "Urls": [
    "https://www.yelp.com/biz/coffee-project-new-york-east-village-new-york"
  ],
  "Sort": "Yelp Sort",
  "Rating": "1 star",
  "End_date": "1990-01-01",
  "Max_reviews": 100
}
```

## Output

```json
{
  "business_url": {
    "label": "Business URL",
    "format": "link"
  },
  "business_name": {
    "label": "Business Name",
    "format": "text"
  },
  "average_rating": {
    "label": "Average Rating",
    "format": "text"
  },
  "total_reviews": {
    "label": "Total Reviews",
    "format": "text"
  },
  "price_range": {
    "label": "Price Range",
    "format": "text"
  },
  "business_address": {
    "label": "Business Address",
    "format": "text"
  },
  "contact_number": {
    "label": "Contact Number",
    "format": "text"
  },
  "review_counts_by_rating": {
    "label": "Review Counts by Rating",
    "format": "object"
  },
  "latest_reviewer_name": {
    "label": "Latest Reviewer Name",
    "format": "text"
  },
  "review_avatar_url": {
    "label": "Review Avatar Url",
    "format": "image"
  },
  "review_id": {
    "label": "Review Id",
    "format": "text"
  },
  "latest_reviewer_details": {
    "label": "Latest Reviewer Details",
    "format": "object"
  },
  "latest_reviewer_location": {
    "label": "Latest Reviewer Location",
    "format": "text"
  },
  "latest_reviewer_rating": {
    "label": "Latest Reviewer Rating",
    "format": "text"
  },
  "review_date": {
    "label": "Review Date",
    "format": "text"
  },
  "review_text": {
    "label": "Review Text",
    "format": "text"
  },
  "review_media_urls": {
    "label": "Review Media URLs",
    "format": "array"
  },
  "helpful_count": {
    "label": "Helpful Count",
    "format": "text"
  },
  "thanks_count": {
    "label": "Thanks Count",
    "format": "text"
  },
  "love_this_count": {
    "label": "Love This Count",
    "format": "text"
  },
  "oh_no_count": {
    "label": "Oh No Count",
    "format": "text"
  },
  "response_author_name": {
    "label": "Response Author Name",
    "format": "text"
  },
  "response_date": {
    "label": "Response Date",
    "format": "text"
  },
  "response_content": {
    "label": "Response Content",
    "format": "text"
  },
  "review_language": {
    "label": "Review Language",
    "format": "text"
  },
  "reviewer_elite": {
    "label": "Reviewer Elite",
    "format": "text"
  },
  "reviewer_profile_url": {
    "label": "Reviewer Profile URL",
    "format": "link"
  },
  "review_photo_captions": {
    "label": "Review Photo Captions",
    "format": "array"
  },
  "review_counts_by_language": {
    "label": "Review Counts by Language",
    "format": "object"
  },
  "useful_count": {
    "label": "Useful Count",
    "format": "text"
  },
  "funny_count": {
    "label": "Funny Count",
    "format": "text"
  },
  "cool_count": {
    "label": "Cool Count",
    "format": "text"
  },
  "is_first_review": {
    "label": "Is First Review",
    "format": "boolean"
  }
}
```

## About this Actor

This example demonstrates how to use [Yelp Reviews Scraper](https://apify.com/delicious_zebu/yelp-reviews-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/delicious_zebu/yelp-reviews-scraper.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/delicious_zebu/yelp-reviews-scraper.md

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).