Skip to main content

​
Authentication

All Descripio API requests require authentication via Bearer token.

​
Creating an API Key

  1. Log in to app.descripio.com
  2. Navigate to Developer → API Keys
  3. Click “Create API Key”
  4. Choose your plan (Free tier available)
  5. 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 the Authorization 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

Note: GET requests (fetching cached reviews) are unlimited and free.
View full pricing →