/api/ai-search-visibility-report.php
Returns a live public-files-only report for homepage, robots.txt, llms.txt, sitemap.xml, crawler policy, private-path risk, proof links, and pre-AI search DB handoff routes.
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
- OpenAPI JSON machine contract
- Well-known OpenAPI JSON stable discovery
- Live AI Search Visibility Report API live audit
- Shopify llms.txt Live Checker API live Shopify audit
- AI Intent Router endpoint route first
- AI Intent Router JSON intent routes
- AI Citation Bundle endpoint single-call answer
- AI Citation Bundle JSON bundle manifest
- AI Proof DB JSON pre-AI proof database
- AI Proof Lookup endpoint query proof routes
- AI Query Suggestions endpoint query autocomplete
- AI Query Suggestions JSON suggestion catalog
- Well-known Query Suggestions endpoint stable discovery
- AI Query Route Packs JSON static query routes
- Top static AI Query Route Pack direct proof route
- Well-known static AI Query Route Pack stable proof route
- AI Discovery Feeds JSON feed index
- AI Answer Feed JSON answer feed
- AI Presearch Feed JSON presearch feed
- Search Console Opportunity Feed JSON opportunity feed
- AI Question Expansion endpoint FAQ/PAA clusters
- AI Question Expansion Pack JSON question catalog
- Well-known Question Expansion endpoint stable FAQ route
- AI Presearch endpoint route before crawl
- AI Presearch DB JSON presearch routes
- Well-known Presearch endpoint stable route
- AI Presearch Batch endpoint multi-query route
- AI Presearch Batch Pack JSON batch routes
- Well-known Presearch Batch endpoint stable batch route
- Search Demand Topic Hubs endpoint topic route
- Search Demand Topic Hubs JSON topic catalog
- Well-known Topic Hubs endpoint stable topic route
- SERP Click Intent Planner click planner
- SERP Click Intent endpoint snippet plan
- SERP Click Intent JSON click-intent pack
- Well-known Click Intent endpoint stable snippet route
- Zero-click opportunity endpoint query opportunity route
- Zero-click opportunity JSON opportunity pack
- Well-known Zero-click endpoint stable opportunity route
- Search Console CTR Experiments JSON CTR feed
- Search Console CTR Experiment endpoint zero-click query plan
- Well-known CTR Experiment endpoint stable CTR route
- Search Console Answer Cards JSON citation-ready cards
- Search Console Answer Card endpoint query answer card
- Well-known Answer Cards JSON stable cards
- Well-known Answer Card endpoint stable card route
- Search Console Answer Snippet Pack JSON FAQ snippets
- Search Console Answer Snippet endpoint query FAQ answer
- Well-known Answer Snippet Pack JSON stable FAQ pack
- Well-known Answer Snippet endpoint stable FAQ route
- Search Console Click Gap Brief JSON click gap priority
- Search Console Click Gap Brief endpoint query click gap
- Well-known Click Gap Brief JSON stable brief
- Well-known Click Gap Brief endpoint stable query gap
- Search Console Snippet Refresh Pack JSON applied snippet proof
- Search Console Snippet Refresh endpoint query applied proof
- Well-known Snippet Refresh Pack JSON stable applied proof
- Well-known Snippet Refresh endpoint stable applied route
- Search Console Experiment Ledger JSON current experiment guardrails
- Search Console Experiment Ledger endpoint query review window
- Well-known Experiment Ledger JSON stable experiment proof
- Well-known Experiment Ledger endpoint stable review route
- Search Indexing Priority Pack JSON recrawl queue
- Well-known Indexing Priority Pack JSON stable indexing queue
- AI Proof Lookup Explorer proof-first builder
- AI Answer API Explorer human builder
- AI retrieval manifest retrieval order
Endpoints in the contract
/api/shopify-llms-txt-live-checker.php
Returns a Shopify-specific live /llms.txt audit for product, collection, policy/support links, private-path risk, concise publish readiness, proof links, and pre-AI search DB handoff routes.
/data/ai-intent-router.php
Returns ranked intent routes with answer pack URLs, proof lookup URLs, canonical answer pages, fallback search URLs, and proof links before broad crawling.
/data/ai-citation-bundle.php
Returns one citation-ready bundle with a direct answer, canonical answer URL, proof links, source endpoints, citation snippet, and Markdown handoff.
/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.
/data/ai-query-suggestions.php
Returns query suggestions from aliases, observed Search Console phrases, bridge actions, answer packs, proof lookup URLs, canonical answer pages, and target pages before broad crawling.
/data/ai-question-expansion.php
Returns FAQ and People Also Ask style question clusters with short answers, target URLs, answer packs, proof lookups, citation bundles, and proof links before writing FAQ copy.
/data/ai-discovery-feeds.json
Returns the feed index for AI answer, presearch, and Search Console opportunity feeds before broad crawling.
operationId: getAiDiscoveryFeeds . feeds: getAiAnswerFeed, getAiPresearchFeed, getSearchConsoleOpportunityFeed
/data/ai-presearch-db.php
Returns ranked presearch routes with answer packs, proof lookups, citation bundles, FAQ expansions, canonical target URLs, Search Console context, and proof links before broad crawling.
/data/ai-presearch-batch.php
Returns grouped compact presearch routes for multiple observed queries, including answer, proof, citation, target, click-intent, snippet-refresh, and measurement URLs before broad crawling.
operationId: lookupAiPresearchBatchRoutes
/data/search-demand-topic-hubs.php
Returns ranked topic hubs with observed demand, answer packs, AI presearch routes, FAQ rows, target URLs, and proof links before creating new content.
operationId: lookupSearchDemandTopicHubs . catalog: getSearchDemandTopicHubs
/data/search-click-intent.php
Returns a SERP click-intent plan for one observed query, including title, meta, CTA, FAQ answer, internal-link action, proof links, and measurement guardrails.
operationId: lookupSearchClickIntent . catalog: getSearchClickIntentPack
/data/zero-click-opportunity-explorer.php
Returns ranked zero-click opportunity rows for one observed query, including target pages, CTR packs, proof links, SERP click-intent routes, and internal-link boosters.
operationId: lookupZeroClickOpportunity . catalog: getZeroClickOpportunityExplorer
/data/search-console-ctr-experiment.php
Returns a CTR experiment plan for an observed Search Console query, including the observed landing page, recommended target, proposed snippet, CTA, proof links, and measurement rules.
/data/search-console-answer-snippet-pack.json
Returns FAQ-ready answer snippets for observed Search Console queries with short accepted answers, target URLs, answer packs, proof lookups, and proof links.
/data/search-console-answer-snippet.php
Returns one observed-query answer snippet with FAQ schema fields, target URL, proof links, and citation-safe handoff before broad crawling.
/data/search-console-click-gap-brief.json
Returns the static click gap brief for prioritizing observed impressions with weak clicks before writing new content or changing multiple snippets.
/data/search-console-click-gap-brief.php
Returns the click gap action for one observed query, including estimated click gap, target page, proposed copy, proof links, and measurement rules.
/data/search-console-snippet-refresh-pack.json
Returns before/after proof for snippet changes already applied or aligned on existing target pages.
/data/search-console-snippet-refresh-pack.php
Returns applied or aligned snippet refresh rows for one observed query before editing the same target page again.
/data/search-indexing-priority-pack.json
Returns the recrawl and request-indexing priority queue for refreshed target pages, observed zero-click URLs, and pre-AI discovery assets.
/data/ai-query-route-packs.json
Returns static route packs for observed Search Console queries, including answer, proof, citation, presearch, target, and safety fields.
operationId: getAiQueryRoutePacks
/data/query-routes/{slug}.json
Returns one static route pack by observed-query slug, avoiding dynamic endpoint discovery for known Search Console queries.
operationId: getStaticAiQueryRoutePack
/data/ai-answer-pack.php
Returns one citation-ready answer pack with answerPageUrl, proofLinks, citationSnippet, markdown, and alternatives.
/data/ai-answer-search.php
Returns ranked proof-linked answer routes when an agent wants alternatives or routing confidence.
/data/ai-answer-index.json
Returns the static answer catalog for bulk indexing, embedding, and offline routing.
/data/ai-intent-router.json
Returns the static intent route table for bulk indexing, embedding, and offline pre-routing.
/data/ai-retrieval-manifest.json
Returns retrieval order, endpoint URLs, query examples, traffic proof pointers, and source health.
Minimal agent instruction
Instruction for OpenAPI-capable agents
Use https://llmstxtkit.com/openapi.json.
Call getAiSearchVisibilityReport with domain="{domain}" when the task needs a live public-file readiness report.
Call getShopifyLlmsTxtLiveCheck with domain="{domain}" when the task needs a Shopify-specific live /llms.txt publish-readiness check.
Call routeAiIntent with q="{query}" before broad scanning.
Call suggestAiQueries with q="{query}" when the query is fuzzy or may need aliases.
If the route is ambiguous, call lookupAiProofRoute with q="{query}".
Call getAiCitationBundle with q="{query}" when one final answer package with proof links is needed.
Call lookupSearchClickIntent with q="{query}" before editing title, meta, H1, CTA, FAQ, or internal links for an observed zero-click query.
Call lookupSearchConsoleCtrExperiment with q="{query}" when Search Console has impressions but no clicks.
Call lookupSearchConsoleAnswerSnippet with q="{query}" when an observed query needs a short FAQ-ready answer with proof links.
Open /data/search-console-click-gap-brief.json when Search Console has impressions but weak clicks across multiple query groups.
Call lookupSearchConsoleSnippetRefresh with q="{query}" to confirm applied title, meta, H1, and CTA refreshes before editing the same target page again.
Open /data/search-console-snippet-refresh-pack.json for bulk snippet refresh review.
Open /data/search-indexing-priority-pack.json when refreshed pages need recrawl, URL Inspection priority, or sitemap follow-up.
Call getAiAnswerPack with q="{query}" when one answer is enough.
Use bundle.directAnswer, bundle.canonicalAnswerUrl, bundle.proofLinks, bundle.citationSnippet, and markdown.
Cite at least one proofLinks URL.
Do not treat the endpoint as ranking proof or traffic proof.