Get pricing insights

Call this endpoint to retrieve comprehensive pricing insights for your items on Walmart Marketplace. This API provides programmatic access to pricing data that can help you monitor performance, identify pricing opportunities, and make informed pricing decisions.

By using this API, you can retrieve information such as current item prices, Buy Box pricing, competitor pricing, repricer details, price competitiveness metrics, repricer details, and more. The API supports pagination, sorting, and flexible filtering that you can use to retrieve the insights relevant to your business.

This page describes how to use the pricing insights API, including request parameters and sample responses. For a full list of all available response fields and filterable attributes, refer to the Pricing insights API Reference.

Supported filters

The following filters can be used to narrow the results returned by the API.

Endpoint

POST https://marketplace.walmartapis.com/v3/price/getPricingInsights

Sample request

The sample requests in this section show how to query pricing insights data for specific SKUs. The request includes authentication headers, a correlation ID for tracking, and a JSON payload with SKU-based search criteria.

The request supports pagination, filtering, sorting, and SKU-based searches.

pageNumber: The page number to retrieve. Page numbering starts at 0.

• searchCriteria: Retrieves pricing insights for specific SKUs.

  • searchField: The field to search on. For example, SKU.

  • searchValue: Array of SKU values to retrieve. For example, YOUR_SKU_1, YOUR_SKU_2.

    When searchCriteria is provided, the API returns results only for the specified SKUs. Any filter or sort values included in the request are ignored.

• filter: Defines the criterial used to filter results. Multiple filters are combined using an implicit AND operation.
  • name: The field to filer on.
  • operator: The comparison operator. For example, eq for equals, gte for greater than or equal to, in for value is in the list. Refer to the Pricing Insights API Reference for all supported operators.
  • value: The value to compare against (type depends on the field and operator). For example, "name": "isInDemand", "operator": "IN", "value": ["TRUE"]
• sort: Defines the sorting order for the results.
  • sortField: Field use for sorting.
  • sortOrder: The sort direction (ASC for ascending, DESC for descending).

Modify your code

• Replace WM_SEC.ACCESS_TOKEN, WM_QOS.CORRELATION_ID, and WM_SVC.NAME with your actual values.
• Use pageNumber to control pagination.
• If using search for specific items, provide searchCriteria with SearchField set to SKU and an array of searchValue values.
• If you are filtering results, construct the filter array using supported fields, operators, and values.
• If you are sorting results, set sortField and sortOrder as needed.

Retrieve pricing insights for specific SKUs

The following example retrieves pricing insights for a list of specified SKUs.

curl --request POST \ --url 'https://marketplace.walmartapis.com/v3/price/getPricingInsights' \ --header 'WM_QOS.CORRELATION_ID: YOUR_CORRELATION_ID' \ --header 'WM_SEC.ACCESS_TOKEN: YOUR_ACCESS_TOKEN' \ --header 'WM_SVC.NAME: YOUR_SERVICE_NAME' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "searchCriteria": { "searchField": "SKU", "searchValue": [ "21203526", "Candle-lavender-green-tea", "504312(1)", "hvff" ] }
}'

import requests url = "https://marketplace.walmartapis.com/v3/price/getPricingInsights" headers = { "WM_QOS.CORRELATION_ID": "YOUR_CORRELATION_ID", "WM_SEC.ACCESS_TOKEN": "YOUR_ACCESS_TOKEN", "WM_SVC.NAME": "YOUR_SERVICE_NAME", "accept": "application/json", "content-type": "application/json"
} data = { "searchCriteria": { "searchField": "SKU", "searchValue": [ "21203526", "Candle-lavender-green-tea", "504312(1)", "hvff" ] }
} response = requests.post(url, headers=headers, json=data) print(response.status_code)
print(response.json())

Filter and sort pricing insights

The following example retrieves items that match the specified pricing criteria and sorts the results by GMV in descending order.

curl --request POST \ --url 'https://marketplace.walmartapis.com/v3/price/getPricingInsights' \ --header 'WM_QOS.CORRELATION_ID: YOUR_CORRELATION_ID' \ --header 'WM_SEC.ACCESS_TOKEN: YOUR_ACCESS_TOKEN' \ --header 'WM_SVC.NAME: YOUR_SERVICE_NAME' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "filter": [ { "name": "buyBoxWinRate", "operator": "BETWEEN", "value": [0, 75] }, { "name": "priceCompetitiveness", "operator": "BETWEEN", "value": [0, 100] }, { "name": "gmvL30D", "operator": "BETWEEN", "value": [0, 100] } ], "sort": { "sortField": "GMVL30D", "sortOrder": "DESC" }, "pageNumber": 0
}'

import requests url = "https://marketplace.walmartapis.com/v3/price/getPricingInsights" headers = { "WM_QOS.CORRELATION_ID": "YOUR_CORRELATION_ID", "WM_SEC.ACCESS_TOKEN": "YOUR_ACCESS_TOKEN", "WM_SVC.NAME": "YOUR_SERVICE_NAME", "accept": "application/json", "content-type": "application/json"
} data = { "filter": [ { "name": "buyBoxWinRate", "operator": "BETWEEN", "value": [0, 75] }, { "name": "priceCompetitiveness", "operator": "BETWEEN", "value": [0, 100] }, { "name": "gmvL30D", "operator": "BETWEEN", "value": [0, 100] } ], "sort": { "sortField": "GMVL30D", "sortOrder": "DESC" }, "pageNumber": 0
} response = requests.post(url, headers=headers, json=data) print(response.status_code)
print(response.json())

Sample response

The sample response shows a successful response containing pricing insights for matching items and pagination metadata.

{ "data": { "pricingInsightsResponseList": [ { "itemName": "Womens Lakeshore Sandal Solid Bone/Bone", "sku": "WLKSD.BNE.0500", "currentPrice": 29.74, "buyBoxBasePrice": 34.99, "buyBoxTotalPrice": 34.99, "buyBoxWinRate": 0.0, "competitorPrice": 33.59, "comparisonPrice": 33.24, "fulfillment": "WALMART_FULFILLED", "inventoryCount": 75, "repricerStrategyType": null, "repricerStatus": null, "repricerMinPrice": null, "repricerMaxPrice": null, "gmv30": null, "inDemand": false, "priceDifferential": null, "priceCompetitiveScore": null, "promoStatus": null, "promoDetails": {}, "reducedReferralStatus": "ELIGIBLE", "walmartFundedStatus": null, "traffic": null, "priceCompetitive": true, "repricerStrategyName": null, "suggestedPrice": 19.99, "suggestedPriceDriver": "WALMART_SUGGESTED_PRICE" } ], "pageContext": { "pageNo": 0, "currentPageCount": 0, "totalCount": 0, "totalPages": 0 } }
}

Result

A successful response (HTTP 200 OK) returns pricing insights for matching items in the pricingInsightsResponseList array and pagination information in the pageContext object.

You can use this data to analyze your pricing strategy, monitor performance, evaluate competitiveness, identify pricing opportunities, and support automated pricing workflows.