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>",
  "review_url": "<string>",
  "product_url": "<string>",
  "asin": "<string>",
  "review_title": "<string>",
  "review_text": "<string>",
  "review_rating": 123,
  "review_date": "<string>",
  "review_date_raw": {},
  "review_verified": true,
  "review_format": "<string>",
  "review_helpful_count": 123,
  "review_images": "<any>",
  "author_name": "<string>",
  "author_profile_url": "<string>",
  "author_avatar": "<string>",
  "total_reviews": 123,
  "total_ratings": 123,
  "country": "<string>",
  "review_category_url": "<string>",
  "is_amazon_vine": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve scraped data from your Amazon Reviews Scraper 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
Unique identifier for the Amazon customer review. Example: R20VZPJE39ZA0O
​
review_url
string
Direct URL to the review on Amazon. Example: https://www.amazon.com/gp/customer-reviews/R20VZPJE39ZA0O
​
product_url
string
Amazon product page URL. Example: https://www.amazon.com/dp/B0D3V4T7K1
​
asin
string
Amazon Standard Identification Number (ASIN) for the product. Example: B0D3V4T7K1
​
review_title
string
Title or headline of the customer review. Example: 1.0 out of 5 stars Disappointing Read
​
review_text
string
Full text content of the customer review. Example: It reads like AI wrote it. Sort paragraphs and the usage of bullet points is excessive. The book has minimal ideas repeated over and over again. It felt like a weird read so I tried to look up the author and other works and could not find much of anything about the author. There is only one blurry photo and no social media. Very disappointing.
​
review_rating
integer
Star rating given by the reviewer (1 to 5). Example: 1
​
review_date
string
Review date as displayed on Amazon (e.g. Reviewed in the United States on January 26, 2026). Example: Reviewed in the United States on January 26, 2026
​
review_date_raw
datetime
Review publication date in ISO 8601 format. Example: 2026-01-26T00:00:00.000Z
​
review_verified
boolean
Whether the reviewer purchased the product on Amazon (Verified Purchase). Example: true
​
review_format
string
Format or variant of the product reviewed (e.g. Paperback, Kindle Edition). Example: Format: Paperback
​
review_helpful_count
integer
Number of users who marked the review as helpful. Example: 3
​
review_images
json
List of image URLs attached to the customer review. Example: ['https://m.media-amazon.com/images/I/81jt3hLUmNL._SY88.jpg']
​
author_name
string
Display name of the reviewer on Amazon. Example: Autumn Autumn
​
author_profile_url
string
URL to the reviewer’s Amazon profile page. Example: https://www.amazon.com/gp/profile/amzn1.account.AFKX2WHZM2VJ7RP4XHRCJD7JXDXQ/ref=cm_cr_getr_d_gw_btm
​
author_avatar
string
URL of the reviewer’s Amazon avatar image. Example: https://m.media-amazon.com/images/S/amazon-avatars-global/default._CR0,0,1024,1024_SX48_.png
​
total_reviews
integer
Total number of written reviews for the product on Amazon. Example: 128
​
total_ratings
integer
Total number of ratings for the product (including those without a written review). Example: 169
​
country
string
Country where the review was posted (e.g. the United States). Example: the United States
​
review_category_url
string
URL to the product’s reviews listing page on Amazon. Example: https://www.amazon.com/Talk-Anyone-Anytime-Anywhere-Communication/product-reviews/B0D3V4T7K1
​
is_amazon_vine
boolean
Whether the review was submitted through the Amazon Vine program. Example: false