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