Authentication
All Descripio API requests require authentication via Bearer token.Creating an API Key
- Log in to app.descripio.com
- Navigate to Developer → API Keys
- Click “Create API Key”
- Choose your plan (Free tier available)
- Copy the key immediately (shown only once)
⚠️ Store your API key securely. It won’t be shown again after creation.
Using Your API Key
Include your API key in theAuthorization header with every request:
Security Best Practices
Never commit keys to Git
Use environment variables:Rotate keys if compromised
Revoke the old key and create a new one immediately via the dashboard.Use separate keys per environment
Create different keys for development, staging, and production.Server-side only
Never expose API keys in client-side code (browsers, mobile apps). Always make API calls from your backend.Key Format
All Descripio API keys follow this format:- Prefix:
dscr_ - Length: 32 characters after prefix
- Characters: alphanumeric + hyphens
Managing API Keys
From the API Keys dashboard you can:- View keys: See all your active keys with usage stats
- Monitor usage: Track requests used vs. monthly quota
- Revoke keys: Immediately disable a key (cannot be undone)
Rate Limits by Plan
| Plan | Refresh Jobs/Month | Rate Limit | Concurrent Jobs |
|---|---|---|---|
| Free | 10 | 1/min | 1 |
| Starter | 100 | 2/min | 2 |
| Pro | 500 | 5/min | 5 |
| Business | 2,000 | 10/min | 10 |
Note: GET requests (fetching cached reviews) are unlimited and free.View full pricing →