.critical-css { }
@media screen
performance++
{ optimize: true }

API Documentation

Integrate Critical CSS generation into your applications.

Authentication

Authenticate your requests using a Bearer token.

Authorization: Bearer YOUR_API_TOKEN
POST

Generate Critical CSS

https://criticalcss.dev/api/critical-css/generate

Parameters

Field Type Description
url string URL to process

Example Request

curl -X POST https://criticalcss.dev/api/critical-css/generate \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com"
  }'
GET

Check Usage

https://criticalcss.dev/api/critical-css/usage

Get your current plan limits and usage statistics.

GET

List Jobs

https://criticalcss.dev/api/critical-css/jobs

Retrieve a list of your recent jobs.

GET

Get Job Data

https://criticalcss.dev/api/critical-css/job/{id}/data

Get detailed data for a specific job, including status and generated CSS availability.

Error Codes

400

Bad Request

Missing required parameters or invalid URL.

401

Unauthorized

Invalid or missing API token.

402

Payment Required

Plan limit reached or subscription expired.

429

Too Many Requests

Rate limit exceeded.

Rate Limits

API usage is limited based on your subscription plan.

Free Plan

5 requests / minute

Pro Plan

60 requests / minute

Enterprise

Unlimited