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.

Walmart API endpoint: https://marketplace.walmartapis.com

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": {} } ] }