API Documentation

Authentication

All API requests require an API key passed via the Authorization header.

Get your API key from Settings (requires a Pro plan).

Submit a URL for roasting. Returns a roast ID that can be used to retrieve the results.

Request Body

{
  "url": "https://example.com"
}

Response

{
  "id": "roast_abc123",
  "status": "processing"
}

Retrieve the results of a completed roast.

Response

{
  "id": "roast_abc123",
  "url": "https://example.com",
  "score": 42,
  "roast": "Your hero section...",
  "suggestions": ["..."],
  "created_at": "2026-04-17T12:00:00Z"
}

Rate Limits