Authentication

Learn how to authenticate your API requests and manage your API keys.

API Keys

All API requests must be authenticated using an API key. Include your API key in the Authorization header as a Bearer token:

curl -X GET "https://api.browsable.app/v1/reddit/search?query=test" \
  -H "Authorization: Bearer YOUR_API_KEY"

Getting an API Key

Sign up for a Browsable account at browsable.app
Navigate to the API Keys page in your dashboard
Click "Create API Key"
Copy and securely store your key

Security Best Practices

Never share your API key publicly
Don't commit API keys to version control
Use environment variables to store your keys
Rotate your keys regularly
Revoke compromised keys immediately

Managing API Keys

You can manage your API keys using the Admin API endpoints:

List API Keys

curl -X GET "https://api.browsable.app/admin/list-keys" \
  -H "Authorization: Bearer YOUR_API_KEY"

Create New API Key

curl -X POST "https://api.browsable.app/admin/create-key" \
  -H "Authorization: Bearer YOUR_API_KEY"

Revoke API Key

curl -X POST "https://api.browsable.app/admin/revoke-key" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key_id": "key_abc123"}'

Rate Limits

Rate limits vary by subscription tier:

Tier	Requests per Minute	Monthly Credits
Free	10	1,000
Starter	60	10,000
Pro	300	100,000
Business	Custom	Custom

Credits System

Each API call consumes credits based on the complexity of the operation:

Reddit Search: 1 credit per request
Reddit Post & Comments: 1 credit per request
Amazon Search: 1 credit per request
Task Generation: 5 credits per generation
Custom Task Execution: Varies by task complexity

Error Responses

Authentication errors return a 401 or 403 status code:

401 Unauthorized

{
  "error": "Missing or invalid API key"
}

403 Forbidden

{
  "error": "Active subscription required to use this API"
}

429 Rate Limit Exceeded

{
  "error": "Rate limit exceeded. Please try again later."
}

Need higher limits?

Contact Sales