Skip to main content

​
API Key Authentication

All Crawleo API requests require authentication using a Bearer token.

​
Getting Your API Key

  1. Sign up at crawleo.dev/login
  2. Subscribe to a plan at crawleo.dev/pricing
  3. Access your API key from the dashboard

​
Using Your API Key

Include your API key in the Authorization header of every request: 
Authorization: Bearer YOUR_API_KEY

​
Example Request

curl -X GET "https://api.crawleo.dev/api/v1/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")
Make API calls from your backend server, not from browser-based JavaScript.
Periodically rotate your API keys, especially if you suspect they may have been compromised.

​
Rate Limiting

API requests are rate-limited based on your subscription plan. If you exceed your rate limit, you’ll receive a 429 Too Many Requests response.

​
Error Responses

Status CodeDescription
401Invalid or missing API key
403API key doesn’t have access to this resource
429Rate limit exceeded