{
 "name": "Agent Ready HTML API",
 "version": "v1",
 "edition": "2026-11-04",
 "documentation": "https://agentreadyhtml.com/developers/",
 "openapi": "https://agentreadyhtml.com/openapi.json",
 "api_catalog": "https://agentreadyhtml.com/.well-known/api-catalog",
 "auth": "none",
 "rate_limit": {
  "requests": 120,
  "window_seconds": 60
 },
 "versioning": {
  "current": "v1",
  "policy": "breaking changes ship under a new prefix; the old prefix stays for 180 days",
  "announcements": "https://agentreadyhtml.com/developers/"
 },
 "endpoints": [
  {
   "path": "/api/v1/search_llms_index",
   "method": "GET",
   "summary": "Search the llms.txt Index",
   "parameters": [
    "q",
    "grade",
    "category",
    "platform",
    "min_links",
    "linked_from_home",
    "limit",
    "cursor"
   ],
   "example": {
    "category": "Developer Tools",
    "grade": "A"
   },
   "paginated": true
  },
  {
   "path": "/api/v1/get_llms_entry",
   "method": "GET",
   "summary": "One domain in the llms.txt Index",
   "parameters": [
    "domain"
   ],
   "example": {
    "domain": "supabase.com"
   },
   "paginated": false
  },
  {
   "path": "/api/v1/grade_distribution",
   "method": "GET",
   "summary": "Grades across the llms.txt Index",
   "parameters": [
    "group_by",
    "min_files"
   ],
   "example": {
    "group_by": "category",
    "min_files": 20
   },
   "paginated": false
  },
  {
   "path": "/api/v1/get_crawl_measure",
   "method": "GET",
   "summary": "Crawl measures of the read layer",
   "parameters": [
    "group_type",
    "group",
    "measure",
    "limit",
    "cursor"
   ],
   "example": {
    "group_type": "headline",
    "measure": "llms.txt"
   },
   "paginated": true
  },
  {
   "path": "/api/v1/list_platforms",
   "method": "GET",
   "summary": "Platforms scored on the read layer",
   "parameters": [
    "id",
    "type",
    "key",
    "limit",
    "cursor"
   ],
   "example": {
    "type": "framework"
   },
   "paginated": true
  },
  {
   "path": "/ask",
   "method": "GET, POST",
   "summary": "NLWeb 0.55 ask",
   "example": {
    "query": "markdown negotiation"
   }
  }
 ],
 "datasets": [
  {
   "key": "index",
   "title": "llms.txt Index rows",
   "description": "One row per plain-text llms.txt found in the crawl: domain, rank, category, platform, size, H1, sections, links, same-site links, whether the home page links it, whether llms-full.txt exists, grade and checks passed.",
   "downloads": [
    {
     "url": "https://agentreadyhtml.com/data/llms-txt-index-2026-11-04.json",
     "type": "application/json"
    },
    {
     "url": "https://agentreadyhtml.com/data/llms-txt-index-2026-11-04.csv",
     "type": "text/csv"
    }
   ]
  },
  {
   "key": "entries",
   "title": "llms.txt Index entries",
   "description": "The parsed entries behind the entry pages: summary, H2 sections, link hosts and the six structure checks with their detail.",
   "downloads": [
    {
     "url": "https://agentreadyhtml.com/data/llms-txt-entries-2026-11-04.json",
     "type": "application/json"
    }
   ]
  },
  {
   "key": "measures",
   "title": "Crawl measures",
   "description": "Read-layer measures of home pages that answered 200: headline, by category and by platform, each with the count, the denominator and the percent.",
   "downloads": [
    {
     "url": "https://agentreadyhtml.com/data/crawl-measures-2026-11-04.json",
     "type": "application/json"
    },
    {
     "url": "https://agentreadyhtml.com/data/crawl-measures-2026-11-04.csv",
     "type": "text/csv"
    }
   ]
  },
  {
   "key": "platforms",
   "title": "Platform scores",
   "description": "The nine rubric keys and the score, evidence, source and read date of each of the 23 platforms.",
   "downloads": [
    {
     "url": "https://agentreadyhtml.com/data/platform-scores-2026-11-04.json",
     "type": "application/json"
    }
   ]
  }
 ],
 "mcp": {
  "endpoint": "https://agentreadyhtml.com/mcp",
  "transport": "streamable-http",
  "protocol_versions": [
   "2025-11-25",
   "2025-06-18",
   "2025-03-26"
  ],
  "server_card": "https://agentreadyhtml.com/mcp/server-card",
  "manifest": "https://agentreadyhtml.com/.well-known/mcp.json",
  "tools": [
   "search_llms_index",
   "get_llms_entry",
   "grade_distribution",
   "get_crawl_measure",
   "list_platforms"
  ]
 },
 "ask": {
  "endpoint": "https://agentreadyhtml.com/ask",
  "protocol": "NLWeb 0.55",
  "methods": [
   "GET",
   "POST"
  ],
  "streaming": "streaming=true or Accept: text/event-stream",
  "example": "markdown negotiation"
 },
 "licence": {
  "name": "CC BY 4.0",
  "url": "https://creativecommons.org/licenses/by/4.0/"
 }
}