GET
/
walmart
/
product
/
price-history
curl -X GET "http://rivin.ai/api/walmart/product/price-history?walmart_product_code=1370971228" \
  -H "Content-Type: application/json" \
  -H "x-api-key: (YOUR_API_KEY_HERE)"
{
	"walmart_product_code":"46275738",
	"priceHistory":
		[
			{"date":"2024-09-02T04:17:40Z","price":39.88},
			{"date":"2024-10-21T04:13:26Z","price":48.39},
			{"date":"2024-10-22T04:14:28Z","price":39.88},
			{"date":"2024-11-18T04:22:31Z","price":37.16},
			{"date":"2024-11-19T04:13:32Z","price":39.88},
			{"date":"2024-12-30T21:09:02Z","price":70.78},
			{"date":"2024-12-31T04:15:07Z","price":39.88},
			{"date":"2025-04-07T04:17:04Z","price":35.99},
			{"date":"2025-04-08T04:13:39Z","price":35.5},
			{"date":"2025-04-09T04:18:39Z","price":39.88},
			{"date":"2025-04-11T04:21:08Z","price":34.79},
			{"date":"2025-04-12T04:14:05Z","price":39.88},
			{"date":"2025-04-29T15:59:21Z","price":35.79},
			{"date":"2025-04-30T04:17:41Z","price":39.88},
			{"date":"2025-05-24T04:17:28Z","price":37},
			{"date":"2025-05-25T04:18:08Z","price":39.88},
			{"date":"2025-05-28T04:22:28Z","price":41.94},
			{"date":"2025-06-07T10:09:50Z","price":38.25},
			{"date":"2025-06-09T04:18:41Z","price":41.94},
			{"date":"2025-06-19T04:18:57Z","price":37.51},
			{"date":"2025-06-20T04:22:19Z","price":41.94},
			{"date":"2025-08-26T19:12:23Z","price":34.99},
			{"date":"2025-08-27T12:55:26Z","price":41.94}
		]
}
Rate Limit: This endpoint has a default rate limit of 10 products/second per account. Need higher limits? Contact our support team - we can accommodate any rate limit requirements on request.
Credit Cost: This endpoint costs 15 credits per successful request. Credits are only deducted when the API call succeeds and returns product data. Failed requests (errors, rate limits, etc.) do not consume credits.
curl -X GET "http://rivin.ai/api/walmart/product/price-history?walmart_product_code=1370971228" \
  -H "Content-Type: application/json" \
  -H "x-api-key: (YOUR_API_KEY_HERE)"
{
	"walmart_product_code":"46275738",
	"priceHistory":
		[
			{"date":"2024-09-02T04:17:40Z","price":39.88},
			{"date":"2024-10-21T04:13:26Z","price":48.39},
			{"date":"2024-10-22T04:14:28Z","price":39.88},
			{"date":"2024-11-18T04:22:31Z","price":37.16},
			{"date":"2024-11-19T04:13:32Z","price":39.88},
			{"date":"2024-12-30T21:09:02Z","price":70.78},
			{"date":"2024-12-31T04:15:07Z","price":39.88},
			{"date":"2025-04-07T04:17:04Z","price":35.99},
			{"date":"2025-04-08T04:13:39Z","price":35.5},
			{"date":"2025-04-09T04:18:39Z","price":39.88},
			{"date":"2025-04-11T04:21:08Z","price":34.79},
			{"date":"2025-04-12T04:14:05Z","price":39.88},
			{"date":"2025-04-29T15:59:21Z","price":35.79},
			{"date":"2025-04-30T04:17:41Z","price":39.88},
			{"date":"2025-05-24T04:17:28Z","price":37},
			{"date":"2025-05-25T04:18:08Z","price":39.88},
			{"date":"2025-05-28T04:22:28Z","price":41.94},
			{"date":"2025-06-07T10:09:50Z","price":38.25},
			{"date":"2025-06-09T04:18:41Z","price":41.94},
			{"date":"2025-06-19T04:18:57Z","price":37.51},
			{"date":"2025-06-20T04:22:19Z","price":41.94},
			{"date":"2025-08-26T19:12:23Z","price":34.99},
			{"date":"2025-08-27T12:55:26Z","price":41.94}
		]
}
This api/walmart/product/price-history endpoint only tracks the Walmart buybox price and time — not prices for each individual seller on a listing.Rivin.ai periodically pulls prices for different products depending on their monthly sales volume, with high-volume products tracked more frequently.If you need to guarantee tracking of a specific product (including prices per seller, inventory in stock per seller, and sales captured per seller), use our /api/walmart/oversight endpoints instead.

Headers

x-api-key
string
required

Your unique API key for authentication. This key is required in the header of all API requests, to authenticate your account and access Rivin.ai's services. Get your API key through the Settings page.

Query Parameters

walmart_product_code
string
required

The (typically) 6-12 digit walmart product code that will be used to search Walmart's catalog.

Response

200
application/json

Successful response

The response is of type object.