Use this report to review listing quality scores, score drivers, issues, and recommended actions for all your published listings. The report provides a daily snapshot of Listing Quality data and is intended to help sellers identify opportunities to improve item performance, discoverability, and conversion potential on Walmart.com.

Note: Listing Quality scores are calculated daily. Report data is accurate as of the previous day and may differ from real-time data displayed in Seller Center.

Requesting an item listing quality report is available for the following endpoints:

• GET | Get All Report Requests
• POST | Create Report Request
• GET | Report Request Status
• GET | Download Report URL
• POST | Create Report Schedule
• GET | Get All Report Schedules
• GET | Get Single Report Schedules

Endpoint

POST https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=LISTING_QUALITY&reportVersion=v1

The request body is optional. When the request is accepted, the API returns a requestId that you can use to track report status and download the completed report.

Sample request

The following example creates a Listing Quality report request. The request body is optional. When the request is accepted, the API returns a requestId that you can use to check the report status and download the completed report.

POST https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType={reportType}&reportVersion=v1
Authorization: Bearer <access_token>
WM_QOS.CORRELATION_ID: <guid>
WM_SVC.NAME: Walmart Marketplace
Accept: application/json
Content-Type: application/json {}

cURL

Use the following cURL example to submit the report request from a command line or script. Replace the placeholder values with your own credentials and request information.

curl --location --request POST 'https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=LISTING_QUALITY&reportVersion=v1' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'WM_SEC.ACCESS_TOKEN: <ACCESS TOKEN>' \
--header 'WM_QOS.CORRELATION_ID: <CORRELATION_ID>' \
--header 'WM_SVC.NAME: WALMART MARKETPLACE' \

Modify your code

• Use a new GUID for each request. Save the returned requestId to check status and download the report.

Track and download

1. Check report status. Poll the report status endpoint until the report is ready.

GET https://marketplace.walmartapis.com/v3/reports/reportRequests/{requestId}

Status values: RECEIVED, INPROGRESS, READY, ERROR.

2. Download the report after the report status changes to READY.

GET https://marketplace.walmartapis.com/v3/reports/downloadReport?requestId={requestId}

If you prefer not to poll for status updates, subscribe to Report Status Notifications and receive a callback when the report is available.

Request filters

Filters are optional. If no filters are specified, the report returns data for all the listings in your catalog, with each row containing data for a unique listing (i.e. OfferID).

You can combine multiple filters in a single request. When multiple filters are provided, the report returns only records that satisfy all specified filters.

Supported filter types

Date filter

Use the snapshotDate field to request data from a specific reporting date.

{ "additionalInfo": { "assortmentAdditionalMetaData": { "snapshotDate": "YYYY-MM-DD" } }
}

Range filter

Use a range filter to return records whose values fall within a minimum and maximum range.

{ "rowFilters": [ { "type": "rangeFilter", "columnName": "LISTING_QUALITY_SCORE", "from": "0", "to": "100", "rowFilterType": "rangeFilter" } ]
}

Enum filter

Use an enum filter to return records that match one or more predefined values.

{ "rowFilters": [ { "type": "enumFilter", "columnName": "ISSUE_PRIORITY", "values": [ "HIGH" ] } ]
}

Combine multiple filter types

You can combine date, range, and enum filters in a single request.

{ "additionalInfo": { "assortmentAdditionalMetaData": { "snapshotDate": "YYYY-MM-DD" } }, "rowFilters": [ { "type": "rangeFilter", "columnName": "CUSTOMER_FAVORITE", "values": [ "TRUE" ] }, { "type": "enumFilter", "columnName": "FAST_AND_FREE_SHIPPING", "values": [ "TRUE" ] }, { "type": "enumFilter", "columnName": "ISSUE_PRIORITY", "values": [ "LOW", "MEDIUM" ] }, { "type": "rangeFilter", "columnName": "LISTING_QUALITY_SCORE", "from": "0", "to": "100", "rowFilterType": "rangeFilter" }, { "type": "rangeFilter", "columnName": "SHIPPING_SCORE", "from": "0", "to": "100", "rowFilterType": "rangeFilter" } ]
}

Supported filter fields

After downloading the report, use your preferred CSV tool to filter data by SKU or report columns.

Report fields

The report contains one row for each Item ID and GTIN combination.

* This report field is a supported filter type.

Error handling

Common failures when requesting or downloading reports: