Request an assortment recommendations report

Use the assortment recommendations report to find items with strong demand where selection is limited. This report helps you identify high potential products to expand your catalog responsibly.

Endpoint

POST https://marketplace.walmartapis.com/v3/reports/reportRequests

Sample request

POST https://marketplace.walmartapis.com/v3/reports/reportRequests
Authorization: Bearer <access_token>
WM_QOS.CORRELATION_ID: <guid>
WM_SVC.NAME: Walmart Marketplace
Content-Type: application/json { "reportType": "ASSORTMENT_RECOMMENDATIONS", "format": "CSV", "rowFilters": { "multiValueFilter": { "parameter": "BRAND", "values": ["Acme", "Contoso"] }, "enumFilter": { "parameter": "ITEM_AVAILABILITY_STATUS", "values": ["EXISTING_IN_WALMART", "NEW_TO_WALMART"] }, "rangeFilter": { "parameter": "PRICE", "floorValue": 10.0, "ceilingValue": 50.0 } }
}

Track and download

1. Track status with GET /v3/reports/reportRequests/{requestId}. Status values are RECEIVED, INPROGRESS, READY, and ERROR.
2. When status is READY, download the file with GET /v3/reports/downloadReport?requestId={requestId}.

Filters

Use the same filter envelope used by other on request reports. Examples below show each filter type in isolation.

Multi value filter

{ "rowFilters": { "multiValueFilter": { "parameter": "CATEGORY", "values": ["Electronics", "Home"] } }
}

Parameters commonly supported include BRAND, CATEGORY, and PRODUCT_TYPE. Provide up to seven values. Values must not be empty. The service applies OR logic across values.

Enum filter

{ "rowFilters": { "enumFilter": { "parameter": "ITEM_AVAILABILITY_STATUS", "values": ["EXISTING_IN_WALMART", "NEW_TO_WALMART"] } }
}

Other enum filter parameters may include SHOPPING_TRENDS and DEMAND_SALES_TRENDS. Confirm the exact list on the report types page.

Range filter

{ "rowFilters": { "rangeFilter": { "parameter": "PRICE", "floorValue": 10.0, "ceilingValue": 50.0 } }
}

Limits

• Rate limit is two calls per seller per hour for this report type.

Report fields

CSV header names are case sensitive. Use the Header (CSV) column when parsing.

Next steps

• Request and download a report
• Use report filters
• Report types
• Examples