Skip to main content

​
API Key Authentication

All Crawleo API requests require authentication using your API key.

​
Getting Your API Key

1

Create an Account

Sign up at crawleo.dev/login.
2

Choose a Plan

Subscribe to a plan at crawleo.dev/pricing.
3

Copy Your Key

Access your API key from the dashboard.

​
Using Your API Key

Include your API key in one of the following headers — both methods are equivalent:
MethodHeaderFormat
Bearer TokenAuthorizationBearer YOUR_API_KEY
X-API-Keyx-api-keyYOUR_API_KEY

​
Example Requests

curl -X GET "https://api.crawleo.dev/search?query=hello" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Security Best Practices

Never expose your API key in client-side code or public repositories.
Store your API key in environment variables rather than hardcoding it:
export CRAWLEO_API_KEY="your_api_key_here"

import os
api_key = os.environ.get("CRAWLEO_API_KEY")

const apiKey = process.env.CRAWLEO_API_KEY;
Make API calls from your backend server, not from browser-based JavaScript. Client-side requests would expose your API key to anyone inspecting the page source.
Periodically rotate your API keys, especially if you suspect they may have been compromised. You can regenerate keys from the dashboard.

​
Error Responses

When authentication fails, you’ll receive one of these error responses:
Status CodeDescriptionCause
401UnauthorizedInvalid or missing API key
403ForbiddenAPI key doesn’t have access to this resource
429Too Many RequestsCredits exhausted or concurrent limit reached
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key."
  }
}

Credits & Pricing

Learn about credit costs, plans, and rate limits.

API Reference

See the full API documentation.
Last modified on April 7, 2026