Get item-level report

Call this endpoint to retrieve detailed item-level performance reports for external affiliate campaigns. This endpoint returns performance data at the individual item/product level, including product details such as item name, category, and product type along with performance metrics. This is useful for understanding which products are driving the most revenue through affiliate channels.

Aggregation levels

CAMPAIGN: Item metrics aggregated at campaign level
ADGROUP: Item metrics aggregated at ad group level

Supported Filters

campaignId: Filter by specific campaign IDs
adGroupId: Filter by specific ad group IDs

Date Range

Maximum date range: 90 days
Data available for the last 12 months

This page describes an example using only the required parameters and inputs to retrieve sales rewards items report. For a full list of customization options and additional capabilities, refer to the Marketplace Attribution Reports API Reference.

Endpoint

GET https://marketplace.walmartapis.com/v3/advertising/wsr/attribution/item-report

Retrieve items report by campaign

This section demonstrates how to retrieve an items report aggregated by the specified CAMPAIGN level for a given date range, with optional filters, sorting, and pagination.

Sample request

curl -X POST "https://marketplace.walmartapis.com/v3/advertising/wsr/attribution/item-report" \ -H "WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6" \ -H "WM_MARKET: US" \ -H "WM_SVC.NAME: Walmart Marketplace" \ -H "WM_SEC.ACCESS_TOKEN: eyJraWQiOi......" \ -H "WM_GLOBAL_VERSION: 3.1" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "performanceBy": "CAMPAIGN", "endDate": "2025-10-31", "filters": [ { "field": "campaignId", "values": [ "987654321" ] } ], "page": { "limit": 10, "offset": 0 }, "sort": { "field": "gmv", "order": "DESC" }, "startDate": "2025-10-01"
}'

import requests url = "https://marketplace.walmartapis.com/v3/advertising/wsr/attribution/item-report" headers = { "WM_QOS.CORRELATION_ID": "b3261d2d-028a-4ef7-8602-633c23200af6", "WM_MARKET": "US", "WM_SVC.NAME": "Walmart Marketplace", "WM_SEC.ACCESS_TOKEN": "eyJraWQiOi......", "WM_GLOBAL_VERSION": "3.1", "Accept": "application/json", "Content-Type": "application/json"
} payload = { "performanceBy": "CAMPAIGN", "startDate": "2025-10-01", "endDate": "2025-10-31", "filters": [ { "field": "campaignId", "values": ["987654321"] } ], "page": { "limit": 10, "offset": 0 }, "sort": { "field": "gmv", "order": "DESC" }
} response = requests.post(url, headers=headers, json=payload) print(response.status_code)
print(response.json())

Modify your code

Use a unique WM_QOS.CORRELATION_ID for each request.
Replace WM_SEC.ACCESS_TOKEN with your valid access token obtained through authentication.

Sample response

The sample response lists details with the relevant identifiers, campaign ID, and metrics such as clicks, orders, GMV, and commissions.

{ "data": [ { "adGroupId": "987654321", "campaignId": "1234567890", "category": "Precious Metals", "creativeId": "112233445", "itemId": "12345", "itemName": "1869 Two Cent Piece MS-65 PCGS (Red/Brown)", "productType": "Precious Metals", "metrics": { "clicks": 250, "gmv": 4000, "orders": 50, "otherCommission": 40, "wsrCommission": 360 } } ], "pagination": { "pageNo": 1, "pageSize": 10, "totalCount": 45, "totalPages": 5 }
}

Result

This call returns a 200 OK with a JSON body containing pagination and a data array. Each item includes the relevant identifier(s) based on campaignId and metrics.

Rate limits

If you submit too many feeds in a short period of time, you may exceed Walmart’s rate limits and receive HTTP 429 (Too Many Requests) responses. For more details on throttling and best practices, refer to the Rate Limiting Guide.

Updated about 5 hours ago