XDataFly

Amazon Reviews API

Fetch Amazon product reviews by ASIN. Supports star filter, sorting, multi-marketplace and pagination. Returns review ID, rating, title, body, masked author, verified purchase flag and helpful votes.

1
credits / per page
GET/v1/amazon/reviews

Parameters

NameTypeRequiredDescription
asinstringrequired10-character Amazon ASINe.g. B0DXK317FN
page_countintegeroptionalNumber of review pages to fetch, 1-10, default 1, charged per pagee.g. 1
sortstringoptionalSort: recent / helpfule.g. recent
starstringoptionalStar filter: all_stars / one_star … five_star / positive / criticale.g. all_stars
reviewer_typestringoptionalReviewer scope: all_reviews / avp_only_reviewse.g. all_reviews
media_typestringoptionalMedia type: all_contents / media_reviews_onlye.g. all_contents
format_typestringoptionalFormat scope: all_formats / current_formate.g. all_formats
sitestringoptionalMarketplace: amz_us / amz_uk / amz_de / amz_fr (four marketplaces supported)e.g. amz_us
include_mediabooleanoptionalWhether to include review image/video URLs, default falsee.g. false

Request example

bash
curl --location 'https://api.xdatafly.com/v1/amazon/reviews?asin=B0DXK317FN&page_count=1&sort=recent&star=all_stars&site=amz_us' \
  --header 'Accept: application/json' \
  --max-time 120 \
  --header 'secret-key: sk_live_xxxxxxxxxxxxxxxx'

Response example

json
{
  "code": 0,
  "data": {
    "asin": "B0DXK317FN",
    "site": "amz_us",
    "reviews": [
      {
        "asin": "B0DXK317FN",
        "body": "Battery lasts all day and the fit is comfortable...",
        "title": "Sounds great",
        "author": "I***o",
        "rating": 5,
        "country": "United States",
        "review_id": "R3C2Q5J7C0DA76",
        "has_avatar": true,
        "vine_voice": false,
        "reviewed_at": "2026-05-23",
        "helpful_votes": 12,
        "verified_purchase": true
      }
    ],
    "total_reviews": 24318,
    "pages_returned": 1,
    "parser_version": "amazon.reviews:2026.10.2"
  },
  "usage": {
    "balance": 975,
    "credits": 25
  },
  "message": "ok",
  "request_id": "req_9b2c41de",
  "duration_ms": 5200
}
  • A single page typically takes 5–40 seconds (scraped from Amazon in real time). Set your client timeout to ≥60s — the common 30s default will time out spuriously.
  • Charged per page: 1 credit × page_count. A failed page is not charged. timeouts and upstream failures release the reserved credits.
  • author is masked (for example I***o) to keep the response compliant.
  • has_avatar tells you whether an avatar existed upstream — the image URL itself is not returned.
  • include_media=true adds review image and video URLs and increases the payload size noticeably.
  • total_reviews is the marketplace-wide count for the ASIN, not just the pages you fetched.