Yelp Reviews

Extract Yelp review text, rating, author, and date from a list of review URLs

$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.

Show all 24 options

en, es, fr, de, it, nl, pt, ru, ja, zh, zh_TW, ko, tr, ar, da, fi, no, sv, he, th, pl, cs, hu, el

Legend: 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 = Greek

View all 24 as a structured list →

Response columns

Field	Display name	Type
businessUrl	Business URL	url
businessName	Business Name	text
reviewText	Review Text	text
rating	Rating	rating
posted	Posted	text
language	Language	text
reviewer	Reviewer	text
reviewerUrl	Reviewer URL	url
reviewerLocation	Reviewer Location	text
reviewerReviews	Reviewer Reviews	number
photos	Photos	text
helpful	Helpful	number
loveThis	Love This	number
ohNo	Oh No	number
thanks	Thanks	number

Example

curl

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
    }
  ]
}