API Key Authentication
All Crawleo API requests require authentication using your API key.Getting Your API Key
- Sign up at crawleo.dev/login
- Subscribe to a plan at crawleo.dev/pricing
- Access your API key from the dashboard
Using Your API Key
Include your API key in one of the following headers: Option 1: Authorization Header (Bearer Token)Example Request
Security Best Practices
Use Environment Variables
Use Environment Variables
Store your API key in environment variables rather than hardcoding it:
Server-Side Only
Server-Side Only
Make API calls from your backend server, not from browser-based JavaScript.
Rotate Keys Regularly
Rotate Keys Regularly
Periodically rotate your API keys, especially if you suspect they may have been compromised.
Credits System
API usage is tracked using credits. Each API call deducts credits from your monthly allowance based on your subscription plan.Credit Costs
| API Endpoint | Credits Cost |
|---|---|
| Search API | 10 credits per page of results |
| Crawl API (no proxy) | 1 credit per page |
| Crawl API (standard proxy) | 2 credits per page |
| Crawl API (premium proxy) | 10 credits per page |
Subscription Plans
| Plan | Credits/Month | Concurrent Requests | Price |
|---|---|---|---|
| Free | 10,000 | 5 | $0/month |
| Developer | 100,000 | 20 | $20/month |
| Pro | 1,000,000 | 50 | $100/month |
| Scale | 2,500,000 | 100 | $200/month |
Full Pricing Details
See detailed credit costs and usage examples.
Concurrent Request Limits
Each plan has a maximum number of concurrent requests. If you exceed this limit, you’ll receive a429 response with the message:
Error Responses
| Status Code | Description | Error Message |
|---|---|---|
401 | Invalid or missing API key | - |
403 | API key doesn’t have access to this resource | - |
429 | Credits exhausted | "Credits exhausted. Please upgrade your plan." |
429 | Concurrent limit reached | "Concurrent request limit reached ({limit}). Please wait for other requests to finish." |