rank-api.json, the OpenAPI 3.1 contract
the API is built against. Request fields, response schemas, and status codes here cannot drift
from the implementation.
Base URL — https://kettio.com
Authentication — Authorization: Bearer agk_live_YOUR_KEY on every request. See
Authentication.
Endpoints
Rank assets
POST /api/v1/rank — score and rank up to 20 assets against one audience.Compare pairs
POST /api/v1/pairwise — five-voter blinded panel on explicit matchups.Code samples here are copyable but not executable in the browser. Kettio’s
/api/v1 routes do
not expose CORS, and requests are not proxied — so run them from your own server or terminal
with a real key rather than expecting a “send” button.Reading the reference
The reference is the contract. It will tell you what a field is, but not when to use it. For that, start with the guides:Rank API guide
Goals, asset types, copy context, and refinement behavior.
How scoring works
What a score is, and the four things it is not.