Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.descripio.com/llms.txt

Use this file to discover all available pages before exploring further.

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:
curl https://app.descripio.com/api/v1/reviews?asin=B08N5WRWNW \
  -H "Authorization: Bearer dscr_abc123..."

Security Best Practices

Never commit keys to Git

Use environment variables:
export DESCRIPIO_API_KEY="dscr_abc123..."
curl -H "Authorization: Bearer $DESCRIPIO_API_KEY" ...

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:
dscr_XXXXXXXXXXXXXXXXXXXXXXXXXXXX
  • 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

PlanRefresh Jobs/MonthRate LimitConcurrent Jobs
Free1001/min1
Starter1,00010/min2
Pro5,00050/min5
Business30,000200/min10
Note: GET requests (fetching cached reviews) are unlimited and free.
View full pricing →