Getting Started
Authentication
All API requests require authentication using your API key. Include your key in the x-api-key header with every request:Credit System
Rivin.ai uses a credit-based pricing model to ensure fair usage and cost-effective access to our data:- Basic API requests (product details lookup, basic data): 1 credit
- Complex queries (price history, units sold history, profitability analysis): up to 150 credits
Rate Limits
Rate limits vary by endpoint and are designed to ensure optimal performance for all users:- Real-time data lookup: Lower rate limits for real-time queries
- Historical data analysis: Higher rate limits due to pulling this data directly from our own databases
Questions or Requests?
If you have data requirements that are not currently supported via Rivin.ai’s API, please reach out by scheduling a call with our team. We’re constantly looking to add depth to our data, and often create new endpoints on customer request.