Extract full Yelp customer reviews & sentiment polarity (no 3-review cap)

Parameters

• aliasstring

  Yelp business slug alias (e.g. houndstooth-coffee-austin). Provide alias or business_id.

  Example: houndstooth-coffee-austin

• business_idstring

  Encrypted Yelp business_id (alternative to alias).

  Example: 6i-32-12abc

• pageinteger

  1-based page number.

  Example: 1

• limitinteger (1 to 50)

  Maximum reviews to return (1–50).

  Example: 20

Example Request (cURL / Python / JavaScript)

curl "https://api.reviewsdataapi.com/v1/yelp/reviews?alias=houndstooth-coffee-austin" \
  -H "x-api-key: rv_live_your_api_key"

import requests

res = requests.get(
    "https://api.reviewsdataapi.com/v1/yelp/reviews?alias=houndstooth-coffee-austin",
    headers={"x-api-key": "rv_live_your_api_key"},
    timeout=30,
)
print(res.json())

const res = await fetch("https://api.reviewsdataapi.com/v1/yelp/reviews?alias=houndstooth-coffee-austin", {
  headers: { "x-api-key": "rv_live_your_api_key" },
});
const data = await res.json();
console.log(data);

Live Response Preview

{
  "code": 0,
  "provider": "https://reviewsdataapi.com",
  "status": "ok",
  "msg": "success",
  "data": {
    "platform": "yelp",
    "business_id": "houndstooth-coffee-austin",
    "sentiment_summary": {
      "sampled_reviews": 20,
      "average_rating": 3.8,
      "star_distribution": {
        "1": 1,
        "2": 3,
        "3": 3,
        "4": 5,
        "5": 8
      },
      "star_percentages": {
        "1": 5,
        "2": 15,
        "3": 15,
        "4": 25,
        "5": 40
      },
      "sentiment_breakdown": {
        "positive_pct": 65,
        "neutral_pct": 15,
        "negative_pct": 20,
        "net_polarity_score": 0.44
      },
      "aspect_polarities": [
        {
          "aspect": "Customer Support",
          "polarity": "positive",
          "positive_pct": 75,
          "mentions": 8
        },
        {
          "aspect": "Quality & Reliability",
          "polarity": "positive",
          "positive_pct": 80,
          "mentions": 5
        }
      ]
    },
    "language_counts": {
      "en": 604
    },
    "reviews": [
      {
        "review_id": "MTthLbOl1VBdGw0C7qREjA",
        "platform": "yelp",
        "business_id": "houndstooth-coffee-austin",
        "rating": 5,
        "review_text": "I enjoy visiting local coffee shops. I was in search of an afternoon coffee and came across Houndstooth on the Yelp app.\n\nParking can be tricky. A lot of spots are reserved for valet parking for Uchiko. I was able to find a spot up front, however I did not realize it was short term parking (10 minutes). Luckily, I was planning to get my coffee to go. Ther...",
        "language": "en",
        "is_featured": false,
        "published_at": "2024-10-07T22:36:00.000Z",
        "sentiment": "positive",
        "polarity_score": 0.93,
        "feedback": {
          "useful": 10,
          "funny": 3,
          "cool": 13
        },
        "author": {
          "id": "7Pk5rbkeZ2_xAPpOPjmRrg",
          "name": "Tiffany J.",
          "location": "Houston, TX",
          "total_reviews": 1069,
          "friend_count": 571,
          "avatar_url": "https://s3-media0.fl.yelpcdn.com/photo/X0InG8O9apnMdynq261XGg/ms.jpg"
        },
        "owner_reply": null
      },
      {
        "review_id": "2z-ofo5QZbYicP_RmH0yCQ",
        "platform": "yelp",
        "business_id": "houndstooth-coffee-austin",
        "rating": 4,
        "review_text": "Went to Houndstooth Coffee around 7 am and it was a really nice way to start the day. Super peaceful and quiet, which is exactly what you want that early in the morning.\n\nI got a latte and a chai latte and both were pretty solid, definitely above average. Nothing crazy or experimental, just well made drinks that hit the spot.\n\nSeating is a bit limited, so...",
        "language": "en",
        "is_featured": false,
        "published_at": "2026-03-25T17:32:47.000Z",
        "sentiment": "positive",
        "polarity_score": 0.74,
        "feedback": {
          "useful": 0,
          "funny": 0,
          "cool": 0
        },
        "author": {
          "id": "cev9dM31_H7Tv47p03J8yQ",
          "name": "Wes Y.",
          "location": "Carson, CA",
          "total_reviews": 55,
          "friend_count": 1,
          "avatar_url": "https://s3-media0.fl.yelpcdn.com/photo/66Y4-Gd_8f0JsODrBEH9hg/ms.jpg"
        },
        "owner_reply": null
      }
    ]
  },
  "meta": {
    "request_id": "999de78a-7f68-45a3-8bd4-ffb78a776e1b",
    "endpoint": "/v1/yelp/reviews",
    "items_returned": 20,
    "credits_charged": 40,
    "cached": true,
    "took_ms": 0
  }
}

Response Fields

Status Codes

200

Normalized cross-platform reputation, star distribution, and sentiment JSON payload.

400

Missing or invalid query parameter (0 credits charged).

401

Missing or invalid rv_live_ API key.

402

Insufficient credit balance.