Get seller's listing quality score

You can view your seller’s Listing Quality score for your entire catalog of listings with the Seller Listing Quality Score API.

The Listing Quality score is based on several metrics that gauge the quality of your item listings: Content, Discoverability, Offer, Ratings and Reviews. If there are issues in these metric categories, your seller’s overall score will decrease.

To view your seller’s Listing Quality score in the Seller Center, go to the Listing Quality Dashboard under Analytics > Growth Opportunities.

Step 1: Call seller listing quality score API

To get a seller’s overall Listing Quality Score, call:

/v3/insights/items/listingQuality/score

The API returns the following listing quality metrics for the seller’s overall catalog:

• Overall Listing Quality – overAllQuality provides the seller’s overall score with a range of values from 0 to 100. The score includes seller’s trending items and WFS items (if the seller participates with Walmart Fulfillment Services) by default. You can exclude these from the score with the query parameters.
• Offer – offerScore value 0 to 100 (e.g. “offerScore”: 56.38)
• Content – contentScore value 0 to 100 (e.g. “contentScore”: 78.0)
• Ratings & Reviews – ratingReviewScore value 0 to 100 (e.g. “ratingReviewScore”: 100.0)
• Post-purchase Quality – itemDefectCnt provides the number of items with issues. defectRatio provides a ratio of available items to defective items.

Upon success, the API returns all metrics with status “OK.”

Step 2: (Optional) Exclude trending items in LQ score

If you want to exclude the seller’s items that are trending (for example: “in demand” items by rank) in the overall Listing Quality score, you can use the viewTrendingItems query parameter set to “false.”

For example, to opt-out of including trending items in the LQ score:

/v3/insights/items/listingQuality/score?viewTrendingItems=false

Step 3: (Optional) Exclude WFS-eligible items from LQ score

If you want the seller’s Listing Quality score to exclude the WFS-eligible items, use the query parameter wfsFlag set to “false.”

For example, to opt-out of including WFS items in the Listing Quality score:

/v3/insights/items/listingQuality/score?wfsFlag=false