curl -X GET "https://rivin.ai/api/walmart/product/details?upc=040094535309" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY_HERE"

​
Welcome to Rivin.ai Walmart API

The Rivin.ai Walmart API provides comprehensive access to Walmart’s product catalog, including real-time pricing, historical data, customer reviews, and product categorization. Build powerful e-commerce applications with accurate, up-to-date product information.

​
API Overview

Our API offers comprehensive Walmart data access across multiple categories:

​
Real-time Product Info

  • GET /walmart/product/details - Retrieve detailed product information using UPC, EAN, or Walmart product codes
  • GET /walmart/product/units-in-stock - Get current inventory levels for each seller of a product
  • GET /walmart/product/fees - Retrieve fee structure information for selling products

​
Historical Product Info

  • GET /walmart/product/price-history - Access historical pricing data for products
  • GET /walmart/product/units-sold-history - Access estimated sales history for products

​
Oversight Tracking

  • POST /walmart/oversight/products - Add products to your oversight tracking system
  • GET /walmart/oversight/products - List all currently tracked oversight products
  • GET /walmart/oversight/products/{id} - Get detailed oversight data for a specific product
  • DELETE /walmart/oversight/products/{id} - Remove products from oversight tracking
Development Status: Some endpoints are currently in development and will be available soon. Check individual endpoint documentation for current availability status.

​
Authentication

All API endpoints require authentication using your API key. Include your key in the x-api-key header with every request: 
"security": [
  {
    "apiKeyAuth": []
  }
]

curl -X GET "https://rivin.ai/api/walmart/product/details?upc=040094535309" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY_HERE"

​
Base URL

All API requests should be made to: 
https://rivin.ai/api

​
Response Format

All API responses are returned in JSON format with appropriate HTTP status codes:
  • 200 - Success
  • 400 - Bad Request (invalid parameters)
  • 401 - Unauthorized (invalid or missing API key)
  • 404 - Not Found
  • 500 - Internal Server Error

​
Rate Limits

Rate limits are applied per API key to ensure fair usage across all users. Contact our team for custom rate limit configurations for high-volume applications.

​
Getting Help

Need assistance with the API? We’re here to help!
  • Discord Community: Join our Discord server for real-time support and discussions with other developers
  • Book a Call: Schedule a 30-minute consultation with our team at cal.com/rivin-ai/30min
  • Email Support: Send us a message at emiliano@rivin.ai
  • Documentation: This reference covers all available endpoints and parameters
  • API Status: Check our status page for real-time API health information