> ## 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

> How to create and use API keys

# Authentication

All Descripio API requests require authentication via Bearer token.

## Creating an API Key

1. Log in to [app.descripio.com](https://app.descripio.com)
2. Navigate to [**Developer → API Keys**](https://app.descripio.com/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:

```bash theme={null}
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:

```bash theme={null}
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](https://app.descripio.com/developer/api-keys) 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 | 100 | 1/min | 1 |
| Starter | 1,000 | 10/min | 2 |
| Pro | 5,000 | 50/min | 5 |
| Business | 30,000 | 200/min | 10 |

> **Note**: GET requests (fetching cached reviews) are unlimited and free.

[View full pricing →](https://descripio.com/en/api/amazon-review-scraper)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.