Find categories with Listing Quality issues
Market availability: US only
You can use the Item listing quality details and Item count with listing quality issues APIs to identify to identify all item categories that currently have items with listing quality issues and retrieve the items count.
These APIs help identify items that have problems with your listings so that you can fix the issues and increase sales with better-quality listings.
Endpoint
Item listing quality details
POST https://marketplace.walmartapis.com/v3/insights/items/listingQuality/itemsItem count with listing quality issues
GET https://marketplace.walmartapis.com/v3/insights/items/listingQuality/countRequest trending WFS-eligible items
Step 1: Call GET categories with listing quality issues API
Call the API /v3/insights/items/listingQuality/count
You can find the number of items within each category that has listing quality issues.
Step 2: Request trending items or WFS items
You can specify query parameters to include or not include items that are WFS-eligible items (for sellers that participate with Walmart Fulfillment Services), or items that have listing-quality issues.
To get these listing-quality details, use the viewTrendingItems, wfsFlag query parameters set to true and hasIssue set to 1. Similarly, to exclude these items from the categories returned with issues, set the hasIssue query parameter to 0.
Note: The
wfsFlagparameter only pertains to sellers that participate in Walmart Fulfillment Services and have published their items for distribution with WFS
Sample request
curl --request POST \ --url https://marketplace.walmartapis.com/v3/insights/items/listingQuality/items \ --header 'WM_GLOBAL_VERSION: 3.1' \ --header 'WM_MARKET: us' \ --header 'WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6' \ --header 'WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....' \ --header 'WM_SVC.NAME: Walmart Service Name' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "query": { "field": "sku", "value": "WB 433KP412-12" }
}
'
Sample response
After you call the Categories with listing quality issues API, the response returns the following information:
- category : Specifies the main category name.
- offerCount: Specifies the number of items with issues within this category.
- productType: Specifies a sub-category of product within the main category.
- productTypeName: Specifies the product name within the product type.
For example, if you have issues with your items in the Furniture category, a response would return the total number of items with issues specified by offerCount (e.g. 47,000). It also provides issue counts for product types within that category (for example, Table).
{ "nextCursor": "AoIFQC8AAAAAAAAATQwRUM0RUVGQTRCODRCNUE5NjE2QjNEMUFGNUNDNUNC", "totalItems": 1, "payload": [ { "qualityScoreData": { "score": 15.5, "values": [ { "impact": "MEDIUM", "scoreType": "content & Discoverability", "scoreValue": 62 }, { "impact": "HIGH", "scoreType": "offer", "scoreValue": 0 }, { "impact": "MEDIUM", "scoreType": "Rating & Reviews", "scoreValue": 0 }, { "impact": "MEDIUM", "scoreType": "Price competitiveness", "scoreValue": 0 }, { "impact": "LOW", "scoreType": "Published and in stock", "scoreValue": 0 }, { "impact": "HIGH", "scoreType": "Shipping speed", "scoreValue": 0 } ] }, "productId": "3F82A2A8W0DJ", "scoreDetails": { "offer": { "shippingSpeed": { "totalIssue": 0, "score": 0, "issueDesc": "Please consider providing free ThreeDay Shipping (enable through Shipping Templates) or TwoDay Shipping for customers", "issueTitle": "Consider Faster Shipping", "shippingType": "Value" }, "price": { "totalIssue": 1, "score": null, "walmartShipping": 0, "additionalDes": null, "competitorShipping": 0, "competitorPrice": { "amount": 34.95, "currency": "USD" }, "price": { "amount": 36.29, "currency": "USD" }, "issueTitle": "Price Not Competitive", "asin": "B00PDHPL5Y" }, "publishAndTransactable": { "score": 0, "issueTitle": "Issue Detected", "maxIssue": 7, "totalIssue": 7, "issues": [ { "date": "2021-05-18", "transactableFlag": false, "publishFlag": true }, { "date": "2021-05-17", "transactableFlag": false, "publishFlag": true }, { "date": "2021-05-16", "transactableFlag": false, "publishFlag": true }, { "date": "2021-05-15", "transactableFlag": false, "publishFlag": true }, { "date": "2021-05-14", "transactableFlag": false, "publishFlag": true }, { "date": "2021-05-13", "transactableFlag": false, "publishFlag": true }, { "date": "2021-05-12", "transactableFlag": false, "publishFlag": true } ] }, "issueCount": 9 }, "contentAndDiscoverability": { "issueCount": 12, "issues": [ { "score": 0, "isEditable": true, "isSpecAttribute": false, "attributeName": "capacity", "issueCount": 1, "issues": [ { "title": "MISSING", "value": "Missing" } ] }, { "score": 100, "isEditable": true, "attributeValue": "Plastic", "isSpecAttribute": false, "attributeName": "material", "issueCount": 0 }, { "score": 0, "isEditable": true, "isSpecAttribute": false, "attributeName": "manufacturer_part_number", "issueCount": 1, "issues": [ { "title": "MISSING", "value": "Missing" } ] }, { "score": 99.9, "isEditable": true, "attributeValue": "Oasis Supply", "isSpecAttribute": true, "attributeName": "brand", "issueCount": 0 }, { "score": 100, "isEditable": true, "attributeValue": "New", "isSpecAttribute": false, "attributeName": "condition", "issueCount": 0 }, { "score": 0, "isEditable": true, "isSpecAttribute": false, "attributeName": "color", "issueCount": 1, "issues": [ { "title": "MISSING", "value": "Missing" } ] }, { "score": 100, "isEditable": true, "attributeValue": "00616450784447", "isSpecAttribute": false, "attributeName": "gtin", "issueCount": 0 }, { "score": 100, "isEditable": true, "attributeValue": "12", "isSpecAttribute": false, "attributeName": "package_quantity", "issueCount": 0 }, { "score": 100, "isEditable": false, "attributeValue": "Multi use", "isSpecAttribute": false, "attributeName": "recommended_use", "issueCount": 0 }, { "score": 0, "isEditable": true, "isSpecAttribute": false, "attributeName": "food_storage_jar_and_container_type", "issueCount": 1, "issues": [ { "title": "MISSING", "value": "Missing" } ] }, { "score": 45, "isEditable": true, "attributeValue": "Dimensions: length: 12.5\" - width: 9 1/2\"Base width at highest point: 2 3/8\"Base width at lowest point: 2\" - total compartment height: 3 1/2\"Compartment top diameter: 2 1/4\" - compartment bottom diameter: 2\"High dome. Crystal clear ,12 per order", "isSpecAttribute": true, "attributeName": "product_long_description", "issueCount": 1, "issues": [ { "title": "NOT_ENOUGH_BULLET_POINTS", "value": "This description includes 0 key feature bullets, while it should contain 5 or more. Please include more key features." } ] }, { "score": 0, "isEditable": true, "isSpecAttribute": true, "attributeName": "number_of_pieces", "issueCount": 1, "issues": [ { "title": "MISSING", "value": "Missing" } ] }, { "score": 71.4, "isEditable": true, "attributeValue": "Oasis Supply 12-Compartment Hinged High Dome Clear Cupcake Container, Clear, 12-Pack", "isSpecAttribute": true, "attributeName": "product_name", "issueCount": 1, "issues": [ { "title": "MISSING_KEY_ATTRIBUTES", "value": "This title includes key attributes such as 'brand', but is missing others such as 'capacity', 'material', and 'recommended use'." } ] }, { "score": 0, "isEditable": true, "isSpecAttribute": false, "attributeName": "features", "issueCount": 1, "issues": [ { "title": "MISSING", "value": "Missing" } ] }, { "score": 100, "isEditable": true, "attributeValue": "This high dome clear cupcake container comes with 12 individual compartments to store a dozen of your delectable cupcakes or muffins. This container is great for bakeries, grocery stores, and catering businesses looking to transport desserts to their events. The high dome structure helps make sure that decorative icing or toppings stay pristine during travel. The lid is detachable, so you'll be able to use this container as its own display without worrying about the top of the lid getting in the way. Just take the top off after your treats have reached their destination, and you're all set up with a grab-and-go dessert station. This container provides a tight, reliable seal, while the crystal clear OPS plastic construction gives your products optimum marketability.", "isSpecAttribute": true, "attributeName": "product_short_description", "issueCount": 0 }, { "score": 46.6, "attributeValue": "2", "isSpecAttribute": true, "attributeName": "images", "issueCount": 5, "issues": [ { "title": "IMAGE_COUNT_TOO_LOW", "value": "This item has only 2 image(s), while this category requires the item have 5 or more images. Please add more images." } ] }, { "score": 0, "isEditable": true, "isSpecAttribute": false, "attributeName": "shape", "issueCount": 1, "issues": [ { "title": "MISSING", "value": "Missing" } ] } ] }, "ratingReviews": { "maxRating": 5, "ratingCount": 0 } }, "wfsEnabled": 0, "priority": "LOW", "categoryName": "Food & Beverage", "updatedTimestamp": "2021-05-20 12:56:28.984", "productName": "Oasis Supply 12-Compartment Hinged High Dome Clear Cupcake Container, Clear, 12-Pack", "itemId": "916854860", "stats": { "orders": "0", "conversionRate": "0", "gmvAmount": { "amount": "0", "currency": "USD" }, "totalUnits": "0" }, "sku": "WB 433KP412-12", "condition": "New", "productType": "Food Storage Jars & Containers", "trends": [ { "statsType": "GMV" }, { "statsType": "pageViews" }, { "statsType": "orders" }, { "statsType": "conversionRate" }, { "values": [ { "value": { "currency": "USD" } } ], "statsType": "totalUnits" } ], "last30DaysConversionRate": 34.3, "last30DaysPageViews": 983, "gmv": 342.3, "isCustomerFavorites": true, "isInStock": true, "isFastAndFreeShipping": true } ], "status": "OK"
}Related links
To learn more about listing quality issues, refer to this Marketplace Learn article.
To get a list of hints to help you fix these content issues with your item listings, refer to the Content and Discoverability section in this Marketplace Learn article.
To review items that are Walmart Best Sellers, navigate to Assortment Growth in the Seller Center .
Updated 9 days ago

