---
title: "Grade a draft title/hook against the patterns currently VALIDATED in live data — this week's data, not a static rubric. Score math runs in code; every component states its basis (measured / ai_judged / rule)."
method: GET
path: "/api/public/grade"
tags: ["intelligence"]
---

# Grade a draft title/hook against the patterns currently VALIDATED in live data — this week's data, not a static rubric. Score math runs in code; every component states its basis (measured / ai_judged / rule).

`GET /api/public/grade`

## Request

- Base URL: `https://lolikai.com`
- URL: `https://lolikai.com/api/public/grade`
- Auth: API key in header `x-lolik-api-key`

## Query parameters

- `draft` string, required

## Response `200`

Success

- Envelope
  - `data` unknown, required
  - `confidence` 'observed' | 'aiEstimated' | 'pending', required
  - `credits_used` integer, required
  - `credits_remaining` integer, required

## Other responses

- `401`: Missing / invalid / revoked key
- `402`: Out of credits (carries credits_remaining + topup_url)
- `429`: Over a rate limit (scope: burst | daily | intel). Retry-After header set.

---

[API](https://skmtc.dev/lolikai/apis/lolik-intelligence-api.md) · [All operations](https://skmtc.dev/lolikai/apis/lolik-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lolikai/apis/lolik-intelligence-api/revisions/426a852610f9?raw)