Skip to main content
GET
/
v1
/
results
Get Results
curl --request GET \
  --url https://api.lobstr.io/v1/results \
  --header 'Authorization: <authorization>'
{
  "review_id": "<string>",
  "url": "<string>",
  "rating": 123,
  "text": "<string>",
  "time_modified": "<string>",
  "language": "<string>",
  "is_featured": true,
  "useful_count": 123,
  "funny_count": 123,
  "cool_count": 123,
  "photo_count": 123,
  "photos": "<string>",
  "video_count": 123,
  "user_name": "<string>",
  "user_id": "<string>",
  "user_location": "<string>",
  "user_review_count": 123,
  "user_friend_count": 123,
  "user_check_in_count": 123,
  "user_photo_count": 123,
  "user_member_since": "<string>",
  "has_user_paid_through_yelp": true,
  "business_url": "<string>",
  "business_id": "<string>",
  "business_name": "<string>",
  "business_avg_rating": 123,
  "business_review_count": 123
}
Retrieve scraped reviews from your Yelp Reviews Export runs.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY

​
Query Parameters

​
squid
string
required
Hash of the squid to get results from
​
run
string
Hash of a specific run (optional)
​
page
integer
Page number (default: 1). Example: 1

​
Result Fields

Each result object contains the following fields:
​
review_id
string
Yelp review ID — unique across the platform. Example: E2HrRt6Pf_l2lzaB_eDc5Q
​
url
string
Direct shareable URL to the review on Yelp. Example: https://www.yelp.com/biz/olio-e-piu-new-york-7?hrid=E2HrRt6Pf_l2lzaB_eDc5Q
​
rating
integer
Star rating given by the reviewer (1–5). Example: 5
​
text
string
Full text of the review. Example: Really great service, food, and ambiance!!
​
time_modified
string
Date and time the review was last posted or modified (UTC, ISO format). Example: 2026-04-04 10:40:18
​
language
string
Language of the review (ISO 639-1 code). Example: en
​
is_featured
boolean
Whether the review is highlighted as featured by Yelp. Example: false
​
useful_count
integer
Community vote count: “Useful”. Example: 12
​
funny_count
integer
Community vote count: “Funny”. Example: 4
​
cool_count
integer
Community vote count: “Cool”. Example: 8
​
photo_count
integer
Number of photos attached to the review. Example: 2
​
photos
string
Comma-separated URLs of photos attached to the review
​
video_count
integer
Number of videos attached to the review. Example: 0
​
user_name
string
Display name of the reviewer. Example: Diana H.
​
user_id
string
Yelp user ID of the reviewer. Example: KrnCBHS68nvCDyLOjC7TwQ
​
user_location
string
Reviewer’s home location as displayed on Yelp. Example: Manhattan, New York, NY
​
user_review_count
integer
Total number of reviews the reviewer has posted on Yelp. Example: 1
​
user_friend_count
integer
Number of friends the reviewer has on Yelp. Example: 12
​
user_check_in_count
integer
Number of check-ins the reviewer has logged on Yelp. Example: 0
​
user_photo_count
integer
Total number of photos the reviewer has uploaded across Yelp. Example: 2
​
user_member_since
string
Date the reviewer joined Yelp (ISO date). Example: 2019-09-05
​
has_user_paid_through_yelp
boolean
Whether the reviewer paid for a service through Yelp’s payment integration. Example: false
​
business_url
string
URL of the business the review is for. Example: https://www.yelp.com/biz/olio-e-piu-new-york-7
​
business_id
string
Yelp business ID. Example: 16ZnHpuaaBt92XWeJHCC5A
​
business_name
string
Business name. Example: Olio e Più
​
business_avg_rating
float
Average rating of the business at the time of scraping. Example: 4.5
​
business_review_count
integer
Total number of reviews on the business at the time of scraping. Example: 7375