Skip to content
Examples

Get Results

Retrieve scraped reviews from Yelp Reviews Export

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped reviews from your Yelp Reviews Export runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

runstringquery

Hash of a specific run (optional)

pageintegerquery

Page number (default: 1). Example: 1

Result Fields

Each result object contains the following fields:

review_idstring

Yelp review ID — unique across the platform. Example: E2HrRt6Pf_l2lzaB_eDc5Q

urlstring

Direct shareable URL to the review on Yelp. Example: https://www.yelp.com/biz/olio-e-piu-new-york-7?hrid=E2HrRt6Pf_l2lzaB_eDc5Q

ratinginteger

Star rating given by the reviewer (1–5). Example: 5

textstring

Full text of the review. Example: Really great service, food, and ambiance!!

time_modifiedstring

Date and time the review was last posted or modified (UTC, ISO format). Example: 2026-04-04 10:40:18

languagestring

Language of the review (ISO 639-1 code). Example: en

is_featuredboolean

Whether the review is highlighted as featured by Yelp. Example: false

helpful_countinteger

Community vote count: "Helpful". Example: 12

thanks_countinteger

Community vote count: "Thanks". Example: 4

love_this_countinteger

Community vote count: "Love This". Example: 8

oh_no_countinteger

Community vote count: "Oh No". Example: 1

reply_textstring

Text of the owner's reply to the review, if any

reply_datetimestring

Date and time the owner reply was posted (UTC, ISO format). Example: 2026-04-10 09:15:00

reply_timestampinteger

Unix timestamp of the owner reply. Example: 1744277700

photo_countinteger

Number of photos attached to the review. Example: 2

photosstring

Comma-separated URLs of photos attached to the review

video_countinteger

Number of videos attached to the review. Example: 0

user_namestring

Display name of the reviewer. Example: Diana H.

user_idstring

Yelp user ID of the reviewer. Example: KrnCBHS68nvCDyLOjC7TwQ

user_locationstring

Reviewer's home location as displayed on Yelp. Example: Manhattan, New York, NY

user_review_countinteger

Total number of reviews the reviewer has posted on Yelp. Example: 1

user_friend_countinteger

Number of friends the reviewer has on Yelp. Example: 12

user_check_in_countinteger

Number of check-ins the reviewer has logged on Yelp. Example: 0

user_photo_countinteger

Total number of photos the reviewer has uploaded across Yelp. Example: 2

user_member_sincestring

Date the reviewer joined Yelp (ISO date). Example: 2019-09-05

has_user_paid_through_yelpboolean

Whether the reviewer paid for a service through Yelp's payment integration. Example: false

is_eliteboolean

Whether the reviewer currently holds Yelp Elite status. Example: true

user_elite_yearsjson

List of years the reviewer held Yelp Elite status. Example: [2024, 2025, 2026]

business_urlstring

URL of the business the review is for. Example: https://www.yelp.com/biz/olio-e-piu-new-york-7

business_idstring

Yelp business ID. Example: 16ZnHpuaaBt92XWeJHCC5A

business_namestring

Business name. Example: Olio e Più

business_avg_ratingfloat

Average rating of the business at the time of scraping. Example: 4.5

business_review_countinteger

Total number of reviews on the business at the time of scraping. Example: 7375

is_recommendedboolean

false for reviews Yelp lists under "not currently recommended" (only when collect_not_recommended_reviews is on), true for regular reviews. Example: true

Response

200
{
  "total_results": 1,
  "limit": 50,
  "page": 1,
  "total_pages": 1,
  "result_from": 1,
  "result_to": 1,
  "data": [
    {
      "id": 49687,
      "object": "result",
      "squid": "7e905dc61cfdd7df956da0871fcca9ce",
      "run": "af1982e76d7b14e9be9b94e217488d1f",
      "review_id": "E2HrRt6Pf_l2lzaB_eDc5Q",
      "url": "https://www.yelp.com/biz/olio-e-piu-new-york-7?hrid=E2HrRt6Pf_l2lzaB_eDc5Q",
      "rating": 5,
      "text": "Really great service, food, and ambiance!! I especially recommend the calamari appetizer.",
      "time_modified": "2026-04-04 10:40:18",
      "language": "en",
      "is_featured": false,
      "helpful_count": 12,
      "thanks_count": 4,
      "love_this_count": 8,
      "oh_no_count": 0,
      "reply_text": null,
      "reply_datetime": null,
      "reply_timestamp": null,
      "photo_count": 2,
      "photos": "https://s3-media0.fl.yelpcdn.com/bphoto/aaa/o.jpg, https://s3-media0.fl.yelpcdn.com/bphoto/bbb/o.jpg",
      "video_count": 0,
      "user_name": "Diana H.",
      "user_id": "KrnCBHS68nvCDyLOjC7TwQ",
      "user_location": "Manhattan, New York, NY",
      "user_review_count": 1,
      "user_friend_count": 12,
      "user_check_in_count": 0,
      "user_photo_count": 2,
      "user_member_since": "2019-09-05",
      "has_user_paid_through_yelp": false,
      "is_elite": false,
      "user_elite_years": null,
      "business_url": "https://www.yelp.com/biz/olio-e-piu-new-york-7",
      "business_id": "16ZnHpuaaBt92XWeJHCC5A",
      "business_name": "Olio e Più",
      "business_avg_rating": 4.5,
      "business_review_count": 7375,
      "functions": null,
      "native_id": 49687
    }
  ],
  "next": null,
  "previous": null
}