Get Results
curl --request GET \
--url https://api.lobstr.io/v1/results \
--header 'Authorization: <authorization>'import requests
url = "https://api.lobstr.io/v1/results"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.lobstr.io/v1/results', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lobstr.io/v1/results",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.lobstr.io/v1/results"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.lobstr.io/v1/results")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lobstr.io/v1/results")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"review_id": "<string>",
"url": "<string>",
"rating": 123,
"text": "<string>",
"time_modified": "<string>",
"language": "<string>",
"is_featured": true,
"helpful_count": 123,
"thanks_count": 123,
"love_this_count": 123,
"oh_no_count": 123,
"reply_text": "<string>",
"reply_datetime": "<string>",
"reply_timestamp": 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,
"is_elite": true,
"user_elite_years": "<any>",
"business_url": "<string>",
"business_id": "<string>",
"business_name": "<string>",
"business_avg_rating": 123,
"business_review_count": 123
}Yelp Reviews Scraper
Get Results
Retrieve scraped reviews from Yelp Reviews Export
GET
/
v1
/
results
Get Results
curl --request GET \
--url https://api.lobstr.io/v1/results \
--header 'Authorization: <authorization>'import requests
url = "https://api.lobstr.io/v1/results"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.lobstr.io/v1/results', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lobstr.io/v1/results",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.lobstr.io/v1/results"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.lobstr.io/v1/results")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lobstr.io/v1/results")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"review_id": "<string>",
"url": "<string>",
"rating": 123,
"text": "<string>",
"time_modified": "<string>",
"language": "<string>",
"is_featured": true,
"helpful_count": 123,
"thanks_count": 123,
"love_this_count": 123,
"oh_no_count": 123,
"reply_text": "<string>",
"reply_datetime": "<string>",
"reply_timestamp": 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,
"is_elite": true,
"user_elite_years": "<any>",
"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
string
required
Your API authentication token. Value:
Token YOUR_API_KEYQuery Parameters
string
required
Hash of the squid to get results from
string
Hash of a specific run (optional)
integer
Page number (default: 1). Example:
1Result Fields
Each result object contains the following fields:string
Yelp review ID — unique across the platform. Example:
E2HrRt6Pf_l2lzaB_eDc5Qstring
Direct shareable URL to the review on Yelp. Example:
https://www.yelp.com/biz/olio-e-piu-new-york-7?hrid=E2HrRt6Pf_l2lzaB_eDc5Qinteger
Star rating given by the reviewer (1–5). Example:
5string
Full text of the review. Example:
Really great service, food, and ambiance!!string
Date and time the review was last posted or modified (UTC, ISO format). Example:
2026-04-04 10:40:18string
Language of the review (ISO 639-1 code). Example:
enboolean
Whether the review is highlighted as featured by Yelp. Example:
falseinteger
Community vote count: “Helpful”. Example:
12integer
Community vote count: “Thanks”. Example:
4integer
Community vote count: “Love This”. Example:
8integer
Community vote count: “Oh No”. Example:
1string
Text of the owner’s reply to the review, if any
string
Date and time the owner reply was posted (UTC, ISO format). Example:
2026-04-10 09:15:00integer
Unix timestamp of the owner reply. Example:
1744277700integer
Number of photos attached to the review. Example:
2string
Comma-separated URLs of photos attached to the review
integer
Number of videos attached to the review. Example:
0string
Display name of the reviewer. Example:
Diana H.string
Yelp user ID of the reviewer. Example:
KrnCBHS68nvCDyLOjC7TwQstring
Reviewer’s home location as displayed on Yelp. Example:
Manhattan, New York, NYinteger
Total number of reviews the reviewer has posted on Yelp. Example:
1integer
Number of friends the reviewer has on Yelp. Example:
12integer
Number of check-ins the reviewer has logged on Yelp. Example:
0integer
Total number of photos the reviewer has uploaded across Yelp. Example:
2string
Date the reviewer joined Yelp (ISO date). Example:
2019-09-05boolean
Whether the reviewer paid for a service through Yelp’s payment integration. Example:
falseboolean
Whether the reviewer currently holds Yelp Elite status. Example:
truejson
List of years the reviewer held Yelp Elite status. Example:
[2024, 2025, 2026]string
URL of the business the review is for. Example:
https://www.yelp.com/biz/olio-e-piu-new-york-7string
Yelp business ID. Example:
16ZnHpuaaBt92XWeJHCC5Astring
Business name. Example:
Olio e Piùfloat
Average rating of the business at the time of scraping. Example:
4.5integer
Total number of reviews on the business at the time of scraping. Example:
7375Response
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
}