Reviews API overview

Use the Review Accelerator Program (RAP) APIs to increase the number of reviews for items with less than fifteen reviews.

With the RAP APIs:

• You can find items eligible to increase reviews through this program.
• The eligible items can be filtered based on the category and price.
• You can perform a wildcard search on item name and search with SKU ID.
• You can sort the items based on item priority, as recommended by Walmart.
• You can view your RAP enrolled items and items that have reached the target number of reviews as part of the program.
• You can enroll and disenroll items into Review Accelerator Program using reviews APIs.
• There is a capability to override the target number of reviews which will be collected through the program at the time of enrollment.

Get RAP post-purchase items API

Use the Get Post-purchase Items API to generate a list of eligible items to enroll them into Post-purchase Review Accelerator Program.

Use the Get RAP Post-purchase items API to:

• Get all Eligible Items: Fetch all items eligible to be enrolled into RAP
• Get all Enrolled Items: Fetch all items enrolled into the program.
• Get all Complete Items: Fetch all items that have reached the target number of reviews as part of the program.

Get RAP post-purchase items with Scroll ID

Use the Scroll ID returned in first Get RAP items API call to fetch subsequent set of items.

• Get subsequent set of items – Specify the Scroll ID in query parameters to get the next set of results corresponding to a scrolling search request.

Item eligibility requirements for review accelerator program:

Walmart determines item eligibility based on a proprietary algorithm that considers various factors:

• Published and in stock status
• Quantity and recency of reviews on the item
• Projected demand 

Item sales, page views, item review count, seasonality, etc. are considered for ranking these items as recommendations to enroll into the program.

Seller eligibility for review accelerator program:

Sellers need to explicitly enroll into the Review Accelerator Program through the Seller Center to access the APIs.

Enroll in Review Accelerator Program:

1. Navigate to the Review Accelerator Program page under Growth Opportunities space.

   

2. Select Enroll items .

   

3. Select an item to enroll.

   

4. Accept Terms and Conditions by selecting the checkbox and clicking on the Agree button.

   

Example: If you try to access the APIs without enrolling through Seller Center, you may encounter the error below.

{ "statusCode": 400, "errors": [ { "code": "400.RR.401", "description": "Seller is not enrolled into the program, Please enrol from Seller Center", "severity": "ERROR", "category": "Authorization" } ]
}

Note: All API call examples shown in this tutorial assume the API endpoint is prepended to the call.

Rate limiting

To promote equitable usage, stability, and reliability, rate limiting is applied to all API calls. More information regarding this can be found in the following sections.

{ "error": [ { "code": "REQUEST_THRESHOLD_VIOLATED.GMP_GATEWAY_API", "info": "You have exceeded your API calls threshold. Check your seller account documentation to find out how many API calls are allowed for your account.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ] }