Skip to main content
GET
/
walmart
/
product
/
units-sold-history
curl -X GET "http://rivin.ai/api/walmart/product/units-sold-history?walmart_product_code=1370971228&time_period=6months" \
  -H "Content-Type: application/json" \
  -H "x-api-key: (YOUR_API_KEY_HERE)"

{
  "walmart_product_code": "1370971228",
  "time_period": "6months",
  "credit_cost": 25,
  "sales_history": [
    {
      "date": "2024-01-15",
      "units_sold": 25
    },
    {
      "date": "2024-01-14",
      "units_sold": 18
    },
    {
      "date": "2024-01-13",
      "units_sold": 32
    }
  ]
}
🚧 Coming Soon: This endpoint is currently in development and will be available soon. Stay tuned for updates!
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 range from 5 to 150 credits depending on the time period requested:
  • 1 month: 5 credits
  • 6 months: 25 credits
  • 1 year: 50 credits
  • 3 years: 100 credits
  • All time: 150 credits
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/units-sold-history?walmart_product_code=1370971228&time_period=6months" \
  -H "Content-Type: application/json" \
  -H "x-api-key: (YOUR_API_KEY_HERE)"

{
  "walmart_product_code": "1370971228",
  "time_period": "6months",
  "credit_cost": 25,
  "sales_history": [
    {
      "date": "2024-01-15",
      "units_sold": 25
    },
    {
      "date": "2024-01-14",
      "units_sold": 18
    },
    {
      "date": "2024-01-13",
      "units_sold": 32
    }
  ]
}
Time Periods: The time_period query parameter is required and specifies how much historical data you need. Longer time periods provide more comprehensive insights but cost more credits.
Sales Estimates: This endpoint provides estimated daily sales data based on various factors including market analysis, historical trends, and available data sources.

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 Walmart product code to get sales history for.

​
time_period
enum<string>
required

The time period for sales history data. Different periods have different credit costs: 1 month (5 credits), 6 months (25 credits), 1 year (50 credits), 3 years (100 credits), all time (150 credits).

Available options:
1month,
6months,
1year,
3years,
alltime

Response

Successful response

​
walmart_product_code
string

The Walmart product code.

​
time_period
enum<string>

The time period for which sales history was requested

Available options:
1month,
6months,
1year,
3years,
alltime
​
credit_cost
integer

The number of credits consumed for this request

​
sales_history
object[]

Array of sales data over time