Octivas Docs

Authentication

Learn how to authenticate your API requests with Octivas using Bearer tokens.

All API requests require authentication using your API key. Include your API key in the Authorization header of each request as a Bearer token.

Authorization Header

Authorization: Bearer your_api_key

Example Request

curl -X POST https://api.octivas.com/api/v1/scrape \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Getting Your API Key

  1. Sign up or log in at octivas.com
  2. Navigate to the API Keys page in your dashboard
  3. Click Create API Key and copy the generated key

Error Responses

If authentication fails, you'll receive one of these responses:

Status CodeMeaning
401 UnauthorizedMissing or invalid API key
403 ForbiddenAPI key is valid but lacks permission for this resource
429 Too Many RequestsRate limit exceeded for your plan

Security Note

Never expose your API key in client-side code. Always make API calls from your server or backend. If you suspect your API key has been compromised, rotate it immediately from your dashboard.

On this page