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