AI Answer API OpenAPI discovery

OpenAPI spec for proof-linked AI answer retrieval.

This page gives agents, automation tools, and developers a stable API contract for the LLMs.txt Kit pre-AI answer database. Start with the answer pack endpoint when one citation-ready answer is enough, or use the ranked search endpoint when alternatives are useful.

Usage rule: cite at least one returned proofLinks URL and do not treat any endpoint as ranking or traffic proof.

OpenAPI files

Endpoints in the contract

GET

/data/ai-proof-lookup.php

Returns ranked pre-AI proof routes with observed query context, answer pack URLs, canonical pages, recommended actions, and proof links.

Open proof lookup sample

GET

/data/ai-answer-pack.php

Returns one citation-ready answer pack with answerPageUrl, proofLinks, citationSnippet, markdown, and alternatives.

Open answer pack sample

GET

/data/ai-answer-search.php

Returns ranked proof-linked answer routes when an agent wants alternatives or routing confidence.

Open ranked search sample

GET

/data/ai-answer-index.json

Returns the static answer catalog for bulk indexing, embedding, and offline routing.

Open answer index JSON

GET

/data/ai-retrieval-manifest.json

Returns retrieval order, endpoint URLs, query examples, traffic proof pointers, and source health.

Open retrieval manifest JSON

Minimal agent instruction

Instruction for OpenAPI-capable agents
Use https://llmstxtkit.com/openapi.json.
Call lookupAiProofRoute with q="{query}" before broad scanning.
Call getAiAnswerPack with q="{query}" when one answer is enough.
Use answer.answerPageUrl, answer.proofLinks, answer.citationSnippet, and markdown.
Cite at least one proofLinks URL.
Do not treat the endpoint as ranking proof or traffic proof.