Products Review API (Deprecated November 2024)

ADD ASIN/ISBN TO PRODUCT REVIEW API QUERY QUEUE

Due to recent Amazon changes, the Products Review API is no longer available.

The request to add an ASIN/ISBN to Product Review query queue. Product Reviews API will query the product reviews with the ability to filter results based on user defined query parameters.

Limitation

API can only retrieve a maximum of 100 reviews per filter combination.

CREDIT DEDUCTION

1 (one) credit deduction (per page of Product Review) after successful retrieval of data. 5 pages of Product Review will consume 5 credits if retrieval is successful.

REQUEST

URI	/api/query/reviews/{ASIN/ISBN}?domain={domain}&secretKey={secretKey}	{ASIN/ISBN} – required – the ASIN or ISBN to add to tracking list {domain} – optional – defaults to www.amazon.com if unspecified valid values [ http://www.amazon.com,/www.amazon.com ] {location} – optional – filter reviews by location as shown in Amazon. E.g. (“United States”, “Mexico”, “United Kingdom” etc.) {datefrom} – optional – filters reviews posted since the given date (Valid pattern “yyyy-MM-dd”) {dateto} – optional – filters reviews posted up to the given date (Valid pattern “yyyy-MM-dd”) {verifiedpurchaseonly} – optional – filters only verified purchased reviews (Valid value: “true” or “false”) {rating} – optional – filters reviews by Star Rating (Valid values: “1”, “2”, “3”, “4”, “5”) {latestonly} – optional – if true, will only get top 10 most recent reviews
Example	/api/query/reviews/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx&location=Mexico&datefrom=2021-01-01&dateto=2021-12-31&verifiedpurchaseonly=true&rating=5&latestonly=true

RESPONSE

Headers
MediaType	application/json
JSON Data

{
    "status": "OK",
    "allowed": 4971,
    "messageId": null,
    "message": null,
    "data": null,
    "rid": "58eb4fb8bfc2333894ce7dc7",
    "dateProcessed": null
}

Note: During callback, the rid can be used to link the callback data to the original request call.

PRODUCT REVIEWS QUERY CALLBACK

PRODUCT REVIEWS QUERY CALLBACK REQUEST

URI	Example: https://your.server.com/amzpecty_result	{Please provide URL in Preferences Page} URL must be SSL enabled. AMZPECTY-API-SECRET-KEY (header name) – secret key header will be included for the call back server to validate the request origin
MediaType	application/json

PRODUCT REVIEWS QUERY CALLBACK JSON SAMPLE DATA

Headers
MediaType	application/json
JSON Data

{
    "status": "OK",
    "responsefor": "productreviews",
    "allowed": 108974,
    "dailyAllowed": 9903,
    "messageId": null,
    "message": null,
    "data": {
        "asin": "B01M5IK8M9",
        "searchStatus": "completed",
        "reviewPagesScanned": 4,
        "requestFilters": {
            "location": "United States",
            "verifiedPurchaseOnly": true,
            "fromDate": "Jan 01, 2021",
            "toDate": "Dec 31, 2021",
            "starRating": "5"
        },
        "totalReviews": 21,
        "totalVerifiedPurchase": 21,
        "reviewLocations": [
            {
                "location": "United States",
                "reviewCount": 21
            }
        ],
        "ratings": [
            {
                "rating": "5.0 out of 5 stars",
                "reviewCount": 21
            }
        ],
        "reviews": [
            {
                "reviewId": "R5N2Q27S1WE1P",
                "customerName": "Spirit_Child",
                "customerProfileLink": "https://www.amazon.com/gp/profile/amzn1.account.AFE7FQ7FOLUVIUTTUKVF3MVMUPFQ/ref=cm_cr_getr_d_gw_btm?ie=UTF8",
                "customerProfileAvatar": "https://images-na.ssl-images-amazon.com/images/G/01/x-locale/common/grey-pixel.gif",
                "reviewTitle": "I love it!",
                "reviewBody": "It delivered on time & it’s what I was expecting!!",
                "reviewLocation": "United States",
                "reviewDate": "Dec 22, 2021",
                "verifiedPurchase": true,
                "variant": "Size: Standard",
                "starRating": 5,
                "starRatingString": "5.0 out of 5 stars"
            }
        ]
    },
    "rid": "628c4494e4b06e3bbeaa8b5b",
    "dateProcessed": 1653359777214,
    "domain": "www.amazon.com",
    "totalCreditsDeducted": 1
}

PRODUCT REVIEW QUERY CALLBACK RESPONSE JSON ATTRIBUTES

Attribute Name	Details
status	The status of the request.
responsefor	“productvariations” value for Product Variations query result
allowed	The current allowed request count. Resets monthly.
dailyAllowed	The current allowed daily request count. Resets daily.
messageId	The id of the message (if any) .
message	The actual message (if any). Pls refer to Error Messages.
rid	The request id. This can be used to match this response to the original request.
dateProcessed	The date the request was processed in unix time format.
domain	The target Amazon domain.
totalCreditsDeducted	This field indicates how many Amzpecty API credits were used to fulfill this request.
data.asin	The ASIN of the product.
data. searchStatus	The search status. [ “in-progress”, “completed”, “error”]
data. reviewPagesScanned	The number of reviews pages scanned
data. requestFilters	The user specified filters for this query request
data. requestFilters. location	Location filter. [“United States”, “Mexico” etc. as shown in Amazon]
data. requestFilters. verifiedPurchaseOnly	true – return verified purchase only
data. requestFilters. fromDate	Review Date from filter. [“yyyy-MM-dd” e.g. “2021-01-01”]
data. requestFilters. toDate	Review Date to filter. [“yyyy-MM-dd” e.g. “2021-12-31”]
data. requestFilters. starRating	Star rating filter [“1”, “2”, “3”, “4”, “5”]
data.totalReviews	The total reviews count.
data. totalVerifiedPurchase	The total verified purchase review count.
data. reviewLocations[]	The list of locations with their corresponding review count
data. reviewLocations[n].location	The review location
data. reviewLocations[n].reviewCount	The review location count
data. ratings []	The list of ratings with their corresponding rating count
data. ratings[n].rating	The review rating
data. ratings[n].reviewCount	The review rating count
data. reviews[]	The list of user reviews with their corresponding information details
data.reviews[n].reviewId	The review Id
data.reviews[n].customerName	The review customer name
data.reviews[n].customerProfileLink	The review profile link
data.reviews[n].customerProfileAvatar	The review profile avatar link
data.reviews[n].reviewTitle	The review title
data.reviews[n].reviewBody	The review body
data.reviews[n].reviewLocation	The review location
data.reviews[n].reviewDate	The review date
data.reviews[n].verifiedPurchase	The review verified purchase flag (“true” if verified)
data.reviews[n].variant	The review product variant
data.reviews[n].starRating	The review star rating
data.reviews[n].starRatingString	The review star rating in string form

GET PRODUCT REVIEWS RESULT BY ASIN/ISBN

The request to get the latest Product Reviews result by ASIN/ISBN.

CREDIT DEDUCTION

0 (zero) credit deduction for the Get call.

REQUEST

URI	/api/query/reviews/asin/{ASIN/ISBN}?domain={domain}&secretKey={secretKey}	{ASIN/ISBN} – the ASIN to get most recent tracking list {domain} – optional – defaults to www.amazon.com if unspecified valid values [ http://www.amazon.com,/www.amazon.com ]
Example	/api/query/reviews/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx

RESPONSE

See Product Reviews Result Query Callback JSON Sample Data

GET PRODUCT REVIEWS RESULT BY RID

The request to get the latest Product Reviews result by RID.

CREDIT DEDUCTION

0 (zero) credit deduction for the Get call.

REQUEST

URI	/api/query/reviews/rid/{rid}?domain={domain}&secretKey={secretKey}	{ RID } – the Request ID to get most recent variant list {domain} – optional – defaults to www.amazon.com if unspecified. See Supported Amazon Domains for list.
Example	/api/query/reviews/rid/628c4494e4b06e3bbeaa8b5b?domain=www.amazon.com&secretKey= xxxxxxxxxx

RESPONSE

See Product Reviews Result Query Callback JSON Sample Data