Find categories with listing quality issues (rewrite)

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/items

Item count with listing quality issues

GET https://marketplace.walmartapis.com/v3/insights/items/listingQuality/count

Request 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 wfsFlag parameter 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?limit=200' \ --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).

"category": "Furniture", "offerCount": 47000, "productType": \[ { "productTypeName": "Table", "offerCount": 20000 }