# Get Results

Retrieve scraped reviews from Yelp Reviews Export

Retrieve scraped reviews from your **Yelp Reviews Export** runs.

## Headers
<ParamField header="Authorization" type="string" required>
  Your API authentication token. Value: `Token YOUR_API_KEY`
</ParamField>

## Query Parameters
<ParamField query="squid" type="string" required>
  Hash of the squid to get results from
</ParamField>

<ParamField query="run" type="string">
  Hash of a specific run (optional)
</ParamField>

<ParamField query="page" type="integer">
  Page number (default: 1). Example: `1`
</ParamField>

## Result Fields

Each result object contains the following fields:

<ResponseField name="review_id" type="string">
  Yelp review ID — unique across the platform. Example: `E2HrRt6Pf_l2lzaB_eDc5Q`
</ResponseField>

<ResponseField name="url" type="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`
</ResponseField>

<ResponseField name="rating" type="integer">
  Star rating given by the reviewer (1–5). Example: `5`
</ResponseField>

<ResponseField name="text" type="string">
  Full text of the review. Example: `Really great service, food, and ambiance!!`
</ResponseField>

<ResponseField name="time_modified" type="string">
  Date and time the review was last posted or modified (UTC, ISO format). Example: `2026-04-04 10:40:18`
</ResponseField>

<ResponseField name="language" type="string">
  Language of the review (ISO 639-1 code). Example: `en`
</ResponseField>

<ResponseField name="is_featured" type="boolean">
  Whether the review is highlighted as featured by Yelp. Example: `false`
</ResponseField>

<ResponseField name="helpful_count" type="integer">
  Community vote count: "Helpful". Example: `12`
</ResponseField>

<ResponseField name="thanks_count" type="integer">
  Community vote count: "Thanks". Example: `4`
</ResponseField>

<ResponseField name="love_this_count" type="integer">
  Community vote count: "Love This". Example: `8`
</ResponseField>

<ResponseField name="oh_no_count" type="integer">
  Community vote count: "Oh No". Example: `1`
</ResponseField>

<ResponseField name="reply_text" type="string">
  Text of the owner's reply to the review, if any
</ResponseField>

<ResponseField name="reply_datetime" type="string">
  Date and time the owner reply was posted (UTC, ISO format). Example: `2026-04-10 09:15:00`
</ResponseField>

<ResponseField name="reply_timestamp" type="integer">
  Unix timestamp of the owner reply. Example: `1744277700`
</ResponseField>

<ResponseField name="photo_count" type="integer">
  Number of photos attached to the review. Example: `2`
</ResponseField>

<ResponseField name="photos" type="string">
  Comma-separated URLs of photos attached to the review
</ResponseField>

<ResponseField name="video_count" type="integer">
  Number of videos attached to the review. Example: `0`
</ResponseField>

<ResponseField name="user_name" type="string">
  Display name of the reviewer. Example: `Diana H.`
</ResponseField>

<ResponseField name="user_id" type="string">
  Yelp user ID of the reviewer. Example: `KrnCBHS68nvCDyLOjC7TwQ`
</ResponseField>

<ResponseField name="user_location" type="string">
  Reviewer's home location as displayed on Yelp. Example: `Manhattan, New York, NY`
</ResponseField>

<ResponseField name="user_review_count" type="integer">
  Total number of reviews the reviewer has posted on Yelp. Example: `1`
</ResponseField>

<ResponseField name="user_friend_count" type="integer">
  Number of friends the reviewer has on Yelp. Example: `12`
</ResponseField>

<ResponseField name="user_check_in_count" type="integer">
  Number of check-ins the reviewer has logged on Yelp. Example: `0`
</ResponseField>

<ResponseField name="user_photo_count" type="integer">
  Total number of photos the reviewer has uploaded across Yelp. Example: `2`
</ResponseField>

<ResponseField name="user_member_since" type="string">
  Date the reviewer joined Yelp (ISO date). Example: `2019-09-05`
</ResponseField>

<ResponseField name="has_user_paid_through_yelp" type="boolean">
  Whether the reviewer paid for a service through Yelp's payment integration. Example: `false`
</ResponseField>

<ResponseField name="is_elite" type="boolean">
  Whether the reviewer currently holds Yelp Elite status. Example: `true`
</ResponseField>

<ResponseField name="user_elite_years" type="json">
  List of years the reviewer held Yelp Elite status. Example: `[2024, 2025, 2026]`
</ResponseField>

<ResponseField name="business_url" type="string">
  URL of the business the review is for. Example: `https://www.yelp.com/biz/olio-e-piu-new-york-7`
</ResponseField>

<ResponseField name="business_id" type="string">
  Yelp business ID. Example: `16ZnHpuaaBt92XWeJHCC5A`
</ResponseField>

<ResponseField name="business_name" type="string">
  Business name. Example: `Olio e Più`
</ResponseField>

<ResponseField name="business_avg_rating" type="float">
  Average rating of the business at the time of scraping. Example: `4.5`
</ResponseField>

<ResponseField name="business_review_count" type="integer">
  Total number of reviews on the business at the time of scraping. Example: `7375`
</ResponseField>

<ResponseField name="is_recommended" type="boolean">
  `false` for reviews Yelp lists under "not currently recommended" (only when `collect_not_recommended_reviews` is on), `true` for regular reviews. Example: `true`
</ResponseField>

## Response

```json 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
}
```
