API Description

This API is used to initiate Amazon product review data collection tasks.
After calling the API, the system will automatically crawl user review data for the target product in the background, helping users comprehensively capture real customer feedback and providing data support for sentiment analysis, product optimization, and market decision-making.

🤖 Pulling this data to power an AI Agent? Instead of writing custom parsing code, leverage our MCP Server to grant your AI workspace native, real-time access with zero integration friction.

Request URL

POST https://scrapeapi.pangolinfo.com/api/v1/scrape

Request Headers

ParametersParameter valueTypeDescription
Content-Typeapplication/jsonstringData format
AuthorizationBearer xxxstringAuthorization Token

Request Parameters

ParametersRequiredTypeDescription
urlYesstringTarget site URL
Note: If omitted, site are required.
siteYesstringSite information
Note: site is optional if url is provided.
Supported countries / marketplaces (9):
amz_us (United States) / amz_de (Germany) / amz_uk (United Kingdom) / amz_au (Australia) / amz_mx (Mexico) / amz_in (India) / amz_eg (Egypt) / amz_ae (United Arab Emirates) / amz_ca (Canada)
bizContextYesobjectBusiness context
formatNostringData return format
formatTypeNostringData return format Type
mediaTypeNostringReview Media Type
parserNameNostringParser name

Business Context Parameters

ParameterTypeDescription
bizKeystringBusiness Context ID
pageCountinteger

Number of pages to retrieve.
Example: pageCount = 2: Fetch pages 1–2 (2 pages total)
(5 credits per page; total = 5 × pages)

asinstringAmazon Standard Identification Number (ASIN)
filterByStarstringStar rating filter
sortBystringSort order

Response value

Return valueTypeDescription
codeintStatus code, 0 means success
messagestringMessage, ok on success
pointCostnumberCredits actually consumed by this request
dataobjectReturned data, see structure below

Return parameter data description

Return valueTypeDescription
jsonobject[]Array of parse results. Each element is one page of results; the review list lives at json[].data.results, described under “Review object fields” below
urlstringTask URL
taskIdstringTask ID

json[] element structure

Return valueTypeDescription
codeintParse status code for this page, 0 means success
messagestringParse message for this page
data.totalReviewsstringTotal review count for the target product; empty when Amazon does not expose the count
data.resultsobject[]Array of review objects on this page, fields below

Review object fields (json[].data.results[])

FieldTypeDescription
reviewIdstringUnique review ID, e.g. R3C2Q5J7C0DA76
authorstringReviewer display name
authorIdstringReviewer account ID (parsed from the profile link, i.e. the XXXX part of amzn1.account.XXXX)
authorLinkstringRelative link to the reviewer’s profile page
authorAvatarstring

Reviewer avatar image URL.
Note: users without a custom avatar return an Amazon generic placeholder, which comes in two forms:
· https://m.media-amazon.com/images/S/amazon-avatars-global/default.png
· https://images-na.ssl-images-amazon.com/images/G/01/x-locale/common/grey-pixel.gif
To detect a “real avatar”, exclude these two placeholder URLs.

starstringRaw star rating text, e.g. 5.0 out of 5 stars (wording varies by marketplace language; extract the number yourself)
titlestringReview title
contentstringReview body
datestringRaw review date text, e.g. May 23, 2026 (format varies by marketplace language)
countrystringCountry/region where the review was written
purchasedbooleanWhether it is a Verified Purchase
vineVoicebooleanWhether the reviewer is a Vine Voice
helpfulstringRaw “helpful” vote text, e.g. 2 people found this helpful; empty string "" when nobody voted (extract the number yourself)
imgsstring[] | nullArray of review image URLs; null when there are no images
videosstring[] | nullArray of review video URLs (usually m3u8 playback URLs); null when there are no videos
attributesobject[] | nullPurchase attributes (e.g. size, color), each element a single key-value object, e.g. {"Size":"Small"}; null when none
asinstringVariant ASIN this review belongs to; may be an empty string "" for some reviews

Request example

curl --request POST \
  --url https://scrapeapi.pangolinfo.com/api/v1/scrape \
  --header 'Authorization: ' \
  --header 'Content-Type: application/json' \
  --data '{
  "url": "https://www.amazon.com",
  "site": "",
  "bizContext": {
    "bizKey": "review",
    "pageCount": 1,
    "asin": "B076CLQDR4",
    "filterByStar": "all_stars",
    "sortBy": "recent"
  },
  "format": "json",
  "formatType": "all_formats",
  "mediaType": "all_contents",
  "parserName": "amzReviewV2"
}'

Return example

For readability, the example below shows 3 representative reviews taken from a real response:
① real avatar + purchase attributes; ② with a review video + “helpful” vote count; ③ boundary case where attributes / asin are empty.

{
  "code": 0,
  "message": "ok",
  "pointCost": 5.0,
  "data": {
    "json": [
      {
        "code": 0,
        "message": "ok",
        "data": {
          "totalReviews": "1,234",
          "results": [
            {
              "reviewId": "R3C2Q5J7C0DA76",
              "author": "Ilen Ferro",
              "authorId": "AEU3VSQZ6DYO2FZC5MOYNZ37OJJQ",
              "authorLink": "/gp/profile/amzn1.account.AEU3VSQZ6DYO2FZC5MOYNZ37OJJQ/ref=cm_cr_arp_d_gw_btm",
              "authorAvatar": "https://m.media-amazon.com/images/S/amazon-avatars-global/836b4724-a4fc-4f3e-9aff-f74a5a7a3b4f._CR0%2C0%2C500%2C500_SX460_.jpeg",
              "star": "5.0 out of 5 stars",
              "title": "Elegante",
              "content": "Maravilloso",
              "date": "May 23, 2026",
              "country": "United States",
              "purchased": true,
              "vineVoice": false,
              "helpful": "",
              "imgs": null,
              "videos": null,
              "attributes": [
                { "Fit Type": "Faux fur collar" },
                { "Size": "Small" },
                { "Color": "New_red" }
              ],
              "asin": "B014CQ8MX4"
            },
            {
              "reviewId": "R1UILPJ47IXO4H",
              "author": "Emily",
              "authorId": "AFOE36W4R64TXNPFZBDBFF5BM3PQ",
              "authorLink": "/gp/profile/amzn1.account.AFOE36W4R64TXNPFZBDBFF5BM3PQ/ref=cm_cr_arp_d_gw_btm",
              "authorAvatar": "https://images-na.ssl-images-amazon.com/images/G/01/x-locale/common/grey-pixel.gif",
              "star": "4.0 out of 5 stars",
              "title": "Cutest Best Coat",
              "content": "Literally the cutest best coat ever. Its warm, super cute, fits me everywhere right as a mid size girly...",
              "date": "April 13, 2026",
              "country": "United States",
              "purchased": true,
              "vineVoice": false,
              "helpful": "2 people found this helpful",
              "imgs": null,
              "videos": [
                "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prod/072f2619-a1fd-495b-9b08-d302b0a10d2a/embedded.cc.default.vertical.jobtemplate.hls.m3u8"
              ],
              "attributes": [
                { "Fit Type": "Faux fur collar" },
                { "Size": "X-Large" },
                { "Color": "Camel" }
              ],
              "asin": "B014CQ8T2S"
            },
            {
              "reviewId": "R2PN4T8OVXKH91",
              "author": "Mister T",
              "authorId": "AF674BPPTRHWB23NEKF7PJAVDDBA",
              "authorLink": "/gp/profile/amzn1.account.AF674BPPTRHWB23NEKF7PJAVDDBA/ref=cm_cr_arp_d_gw_btm",
              "authorAvatar": "https://images-na.ssl-images-amazon.com/images/G/01/x-locale/common/grey-pixel.gif",
              "star": "5.0 out of 5 stars",
              "title": "Great jacket",
              "content": "Wife loved the jacket . Fits true to size and is very warm.",
              "date": "April 9, 2026",
              "country": "United States",
              "purchased": true,
              "vineVoice": false,
              "helpful": "",
              "imgs": null,
              "videos": null,
              "attributes": null,
              "asin": ""
            }
          ]
        }
      }
    ],
    "url": "https://www.amazon.com",
    "taskId": "647ff502c31148b4af85bde03f8b0867"
  }
}

Credit Consumption

  • Average response time: 10s
  • Credit consumption: 5 credits/per request