Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt

Use this file to discover all available pages before exploring further.

$0.4 / 1k reviews Extract Yelp review text, rating, author, and date from a list of review URLs

​
Endpoint

POST /api/v1/agents/yelp/reviews/run

​
Parameters

​
urls
array
required
List · Yelp business URLs (e.g. https://www.yelp.com/biz/bar-54-new-york-2). One per line.
​
maxReviewsPerListing
integer
default:100
Number · Reviews per business URL. Use 0 for all.
​
fromDate
date
Date picker · Earliest review date. Leave blank for no lower bound.
​
toDate
date
Date picker · Latest review date. Leave blank for no upper bound.
​
language
string
Dropdown · Filter to reviews in this language. Leave blank for all.
en, es, fr, de, it, nl, pt, ru, ja, zh, zh_TW, ko, tr, ar, da, fi, no, sv, he, th, pl, cs, hu, elLegend: en = English, es = Spanish, fr = French, de = German, it = Italian, nl = Dutch, pt = Portuguese, ru = Russian, ja = Japanese, zh = Chinese (Simplified), zh_TW = Chinese (Traditional), ko = Korean, tr = Turkish, ar = Arabic, da = Danish, fi = Finnish, no = Norwegian, sv = Swedish, he = Hebrew, th = Thai, pl = Polish, cs = Czech, hu = Hungarian, el = GreekView all 24 as a structured list →

​
Response columns

FieldDisplay nameType
businessUrlBusiness URLurl
businessNameBusiness Nametext
reviewTextReview Texttext
ratingRatingrating
postedPostedtext
languageLanguagetext
reviewerReviewertext
reviewerUrlReviewer URLurl
reviewerLocationReviewer Locationtext
reviewerReviewsReviewer Reviewsnumber
photosPhotostext
helpfulHelpfulnumber
loveThisLove Thisnumber
ohNoOh Nonumber
thanksThanksnumber

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/yelp/reviews/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "urls": [
      {
        "url": "https://www.yelp.com/biz/katzs-delicatessen-new-york"
      }
    ],
    "maxReviewsPerListing": 10
  }
}'

​
Example response

Response
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "businessUrl": "https://www.yelp.com/biz/katzs-delicatessen-new-york",
      "businessName": "Katz's Delicatessen",
      "reviewText": "I love green tomato pickles!!! Never had a like this tasty pickles in my life;) Of course other pickles are fantastic as well, amazing pastrami beefs!!",
      "rating": 5,
      "posted": "2021-11-15T17:48:58Z",
      "language": "ja",
      "reviewer": "Colie S.",
      "reviewerUrl": "https://www.yelp.com/user_details?userid=3OBbVbGPiQGNCYeBm0ygCw",
      "reviewerLocation": "Foster City, CA",
      "reviewerReviews": 26,
      "photos": [
        "https://s3-media0.fl.yelpcdn.com/bphoto/6Q0wk_TvEWCvefcs93DWjA/o.jpg",
        "https://s3-media0.fl.yelpcdn.com/bphoto/7Y3il0AbnujWge8dH_QSMQ/o.jpg",
        "https://s3-media0.fl.yelpcdn.com/bphoto/JGu9koH5ZKuE_O0JU83UXg/o.jpg",
        "https://s3-media0.fl.yelpcdn.com/bphoto/a3d0pVS0q9wgYG5PM3Dx4g/o.jpg",
        "https://s3-media0.fl.yelpcdn.com/bphoto/RfLXi_7rUL4LharePs2lTg/o.jpg",
        "https://s3-media0.fl.yelpcdn.com/bphoto/yGe8L_W6XndSqokVb4W5Pg/o.jpg"
      ],
      "helpful": 0,
      "loveThis": 0,
      "ohNo": 0,
      "thanks": 0
    }
  ]
}