Authentication

All API requests must include your API key in the request header.

Getting your API key

Go to Settings → API → Generate Key.

Making authenticated requests

Include your key in the Authorization header:

curl https://api.blazesites.net/v1/pages \
  -H "Authorization: Bearer blz_live_your_api_key_here" \
  -H "Content-Type: application/json"

Base URL

https://api.blazesites.net/v1

All requests must use HTTPS.

Response format

All responses return JSON:

{
  "data": { ... },
  "meta": {
    "timestamp": "2025-06-01T12:00:00Z",
    "version": "1"
  }
}

Errors return:

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key."
  }
}

Rate limits

When rate limited, you receive a 429 Too Many Requests response with a Retry-After header.