Skip to main content
GET
Get Results
Retrieve scraped reviews from your Yelp Reviews Export runs.

Headers

string
required
Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

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

Result Fields

Each result object contains the following fields:
string
Yelp review ID — unique across the platform. Example: E2HrRt6Pf_l2lzaB_eDc5Q
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
integer
Star rating given by the reviewer (1–5). Example: 5
string
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:18
string
Language of the review (ISO 639-1 code). Example: en
Whether the review is highlighted as featured by Yelp. Example: false
integer
Community vote count: “Helpful”. Example: 12
integer
Community vote count: “Thanks”. Example: 4
integer
Community vote count: “Love This”. Example: 8
integer
Community vote count: “Oh No”. Example: 1
string
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:00
integer
Unix timestamp of the owner reply. Example: 1744277700
integer
Number of photos attached to the review. Example: 2
string
Comma-separated URLs of photos attached to the review
integer
Number of videos attached to the review. Example: 0
string
Display name of the reviewer. Example: Diana H.
string
Yelp user ID of the reviewer. Example: KrnCBHS68nvCDyLOjC7TwQ
string
Reviewer’s home location as displayed on Yelp. Example: Manhattan, New York, NY
integer
Total number of reviews the reviewer has posted on Yelp. Example: 1
integer
Number of friends the reviewer has on Yelp. Example: 12
integer
Number of check-ins the reviewer has logged on Yelp. Example: 0
integer
Total number of photos the reviewer has uploaded across Yelp. Example: 2
string
Date the reviewer joined Yelp (ISO date). Example: 2019-09-05
boolean
Whether the reviewer paid for a service through Yelp’s payment integration. Example: false
boolean
Whether the reviewer currently holds Yelp Elite status. Example: true
json
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-7
string
Yelp business ID. Example: 16ZnHpuaaBt92XWeJHCC5A
string
Business name. Example: Olio e Più
float
Average rating of the business at the time of scraping. Example: 4.5
integer
Total number of reviews on the business at the time of scraping. Example: 7375