Agent Ready HTML

The Plain Fetch viewer

In short

The viewer requests a URL the way a plain-fetch agent does: no JavaScript, one request for HTML, one for markdown, one for llms.txt and one for a path that should not exist. It shows the initial HTML on the left, the readable text on the right, and seven flags underneath.

Pre-loaded with www.wikipedia.org, read 4 November 2026. Type any public URL to run your own.

GET https://docs.perplexity.ai/ answered 200 with text/html, 218 KB, 1 redirect, read 8 November 2026, 13:49 UTC. Final URL: https://docs.perplexity.ai/docs/getting-started/overview.

Permalink: /viewer/?url=https://docs.perplexity.ai/

A plain-fetch client does not get the heading: 5 of 6 checks found.

Initial HTML what a plain fetch receives

<!doctype html>
<html
  lang="en"
  class="dark"
  data-banner-state="visible"
  data-assistant-state="closed"
  data-page-mode="none"
  data-current-path="/"
>
  
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
<title>Overview - Perplexity
</title>
[... 8 more head elements folded ...]
<meta data-mint-head name="description" content="Perplexity API Platform - build with the Orchestrator, Agent, Search, Embeddings, and Decisions APIs. Real-time, web-wide research and Q&amp;A capabilities for your products.">
[... 1 more head element folded ...]
<meta data-mint-head name="generator" content="Mintlify">
[... 27 more head elements folded ...]
<link data-mint-head rel="canonical" href="https://docs.perplexity.ai/docs/getting-started/overview">
<link data-mint-head rel="alternate" type="application/xml" href="/sitemap.xml">
<link data-mint-head rel="alternate" type="text/markdown" href="/docs/getting-started/overview.md">
[... 22 more head elements folded ...]
</head>
  
<body class="antialiased">
    
<svg aria-hidden="true" style="position:absolute;width:0;height:0;overflow:hidden">[... 922 characters folded ...]
</svg></symbol><symbol id="mi-mint-1-Expand" overflow="visible">
<svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewBox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="inherit" stroke-linecap="round" stroke-linejoin="round" style="overflow:visible">[... 428 characters folded ...]
</svg></symbol><symbol id="mi-mint-1-Close" overflow="visible">
<svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewBox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="inherit" stroke-linecap="round" stroke-linejoin="round" style="overflow:visible">[... 190 characters folded ...]
</svg></symbol><symbol id="mi-mint-1-Attach" overflow="visible">
<svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewBox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="inherit" stroke-linecap="round" stroke-linejoin="round" style="overflow:visible">[... 322 characters folded ...]
</svg></symbol><symbol id="mi-mint-1-Send" overflow="visible">
<svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewBox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="inherit" stroke-linecap="round" stroke-linejoin="round" style="overflow:visible">[... 238 characters folded ...]
</svg></symbol><symbol id="mi-mint-1-ChevronRight" overflow="visible">
<svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewBox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="inherit" stroke-linecap="round" stroke-linejoin="round" style="overflow:visible"><path d="M6.5 2.75L12.75 9L6.5 15.25" stroke="currentColor" width="1.5" linecap="round" linejoin="round"></path>
</svg></symbol><symbol id="mi-mint-1-Menu" overflow="visible">
<svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewBox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="inherit" stroke-linecap="round" stroke-linejoin="round" style="overflow:visible">[... 301 characters folded ...]
</svg></symbol><symbol id="mi-mint-1-Search" overflow="visible">
<svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewBox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="inherit" stroke-linecap="round" stroke-linejoin="round" style="overflow:visible">[... 358 characters folded ...]
</svg></symbol><symbol id="mi-mint-1-ThemeSystem" overflow="visible">
<svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewBox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="inherit" stroke-linecap="round" stroke-linejoin="round" style="overflow:visible">[... 478 characters folded ...]
</svg></symbol><symbol id="mi-mint-1-ThemeLight" overflow="visible">
<svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewBox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="inherit" stroke-linecap="round" stroke-linejoin="round" style="overflow:visible">[... 1,076 characters folded ...]
</svg></symbol><symbol id="mi-mint-1-ThemeDark" overflow="visible">
<svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" viewBox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="inherit" stroke-linecap="round" stroke-linejoin="round" style="overflow:visible">[... 317 characters folded ...]
</svg></symbol>
</svg>
    
<div id="root">
<link rel="preload" as="image" href="https://mintcdn.com/perplexity/gHf_T6roVjp3yaJv/logo/Perplexity_API_Platform.svg?fit=max&amp;auto=format&amp;n=gHf_T6roVjp3yaJv&amp;q=85&amp;s=07cab879ca2ce031bbc3da8b20f7ab90"/>
<link rel="preload" as="image" href="https://mintcdn.com/perplexity/gHf_T6roVjp3yaJv/logo/Perplexity_API_Platform_Light.svg?fit=max&amp;auto=format&amp;n=gHf_T6roVjp3yaJv&amp;q=85&amp;s=416d5342d11094201b851dcf3eabdc9d"/>
<link rel="preload" as="image" href="/logo/Perplexity_API_Platform.svg"/>
<link rel="preload" as="image" href="/logo/Perplexity_API_Platform_Light.svg"/>
<style data-precedence="base-ui:low" data-href="base-ui-disable-scrollbar">.base-ui-disable-scrollbar{scrollbar-width:none}.base-ui-disable-scrollbar::-webkit-scrollbar{display:none}
</style>
<link rel="preload" href="/fonts/GT-Standard-S-Standard-Light.woff2" as="font" type="font/woff2" crossorigin="anonymous"/>
<link rel="preload" href="/fonts/GT-Standard-S-Standard-Light.woff2" as="font" type="font/woff2" crossorigin="anonymous"/>
<link rel="preload" href="/_mintlify/assets/katex-TwdgeFTe.css?dpl=dpl_FWZhTb2vab28gFGFH4ojka6qEznQ" as="style" fetchPriority="low" data-mint-katex=""/>
<script>[... 413 characters folded ...]
</script><blockquote class="sr-only" data-agent-docs-index="true" aria-hidden="true">
<h2>Documentation Index
</h2>
<p>Fetch the complete documentation index at:<!-- --> <a href="/llms.txt" tabindex="-1">/llms.txt</a>
</p>
<p>Use this file to discover all available pages before exploring further.
</p></blockquote>
<script id="_mintlify-banner-script">[... 1,867 characters folded ...]
</script>
<style>[... 159 characters folded ...]
</style>
<style>[... 159 characters folded ...]
</style>
<style>[... 316 characters folded ...]
</style>
<style>[... 512 characters folded ...]
</style>
<script type="text/javascript">[... 410 characters folded ...]
</script>
<div class="relative antialiased text-gray-500 dark:text-gray-400 [[&amp;_:is(h1,h2,h3,h4,h5,h6)]:font-headingsWeight [&amp;_*:not(h1,h2,h3,h4,h5,h6,strong,b,h1_*,h2_*,h3_*,h4_*,h5_*,h6_*,strong_*,b_*)]:font-bodyWeight">
<script id="_mintlify-navbar-transition-script">[... 1,632 characters folded ...]
</script>
<script id="_mintlify-scroll-margin-script">[... 4,239 characters folded ...]
</script><a href="#content-area" class="sr-only focus:not-sr-only focus:fixed focus:top-2 focus:left-2 focus:z-50 focus:p-2 focus:text-sm focus:bg-background-light dark:focus:bg-background-dark focus:rounded-md focus:outline-primary dark:focus:outline-primary-light">Skip to main content</a>
<script>[... 1,533 characters folded ...]
</script>
<div class="max-lg:contents lg:flex lg:w-full" data-docs-theme="almond" data-assistant-layout="legacy">
<div data-assistant-sheet-container="" class="sticky shrink-0 z-22 lg:order-last pt-2 pb-2 pr-2 mt-(--banner-height,0px) top-(--banner-height,0px) h-[calc(100vh-var(--banner-height,0px))] max-lg:hidden print:hidden" style="width:var(--assistant-sheet-width, 0px);overflow:hidden">
<div class="absolute left-0 top-0 bottom-0 w-px z-10 cursor-col-resize after:content-[&quot;&quot;] after:absolute after:inset-y-0 after:-inset-x-2 after:select-none">
</div>
<div id="chat-assistant-sheet" class="flex flex-col overflow-hidden shrink-0 relative h-full bg-background-light dark:bg-background-dark rounded-2xl border border-gray-200/70 dark:border-white/[0.07] chat-assistant-sheet" aria-hidden="true">
<div class="w-full flex flex-col flex-1 min-h-0 lg:pt-3">
<div class="chat-assistant-sheet-header flex items-center justify-between pb-3 px-4">
<div class="flex items-center gap-2">
<svg aria-hidden="true" width="18" height="18" stroke-width="1.5" class="size-5 text-primary dark:text-primary-light shrink-0"><use href="#mi-mint-1-Sparkle"></use>
</svg><span class="font-medium text-gray-900 dark:text-gray-100">Assistant</span>
</div>
<div class="flex items-center gap-1"><button class="group hover:bg-gray-100 dark:hover:bg-white/10 p-1.5 rounded-lg" aria-label="Maximize assistant panel">
<svg aria-hidden="true" width="18" height="18" stroke-width="2" focusable="false" class="size-4 sm:size-3.5 text-gray-500 group-hover:text-gray-700 dark:group-hover:text-gray-300 shrink-0"><use href="#mi-mint-1-Expand"></use>
</svg></button><button class="group hover:bg-gray-100 dark:hover:bg-white/10 p-1.5 rounded-lg" aria-label="Close assistant panel">
<svg aria-hidden="true" width="18" height="18" stroke-width="2" focusable="false" class="size-[20px] sm:size-4 text-gray-500 group-hover:text-gray-700 dark:group-hover:text-gray-300 shrink-0"><use href="#mi-mint-1-Close"></use>
</svg></button>
</div>
</div>
<div id="chat-content" class="chat-assistant-sheet-content flex flex-col-reverse flex-1 overflow-y-auto relative px-5 min-h-0">
<div class="grow">
</div>
<div class="h-full flex flex-col justify-between">
<div class="mt-4 flex flex-col items-center text-sm">
<div class="mx-8 text-center text-gray-400 dark:text-gray-600 text-xs chat-assistant-disclaimer-text">Responses are generated using AI and may contain mistakes.
</div>
</div>
<div class="pb-6">
<div class="flex flex-col gap-4">
<p class="text-sm text-gray-700 dark:text-gray-300 starter-question-text">Suggestions
</p><button class="font-medium text-left text-sm text-primary hover:brightness-[0.75] dark:hover:brightness-[1.35] dark:text-primary-light dark:hover:text-primary transition-colors">What is the Agent API?</button><button class="font-medium text-left text-sm text-primary hover:brightness-[0.75] dark:hover:brightness-[1.35] dark:text-primary-light dark:hover:text-primary transition-colors">Which Agent API model should I use?</button><button class="font-medium text-left text-sm text-primary hover:brightness-[0.75] dark:hover:brightness-[1.35] dark:text-primary-light dark:hover:text-primary transition-colors">How do I create an API key?</button>
</div>
</div>
</div>
</div>
<div class="px-4 pb-4 shrink-0">
<div class="">
<div class="flex flex-col w-full rounded-2xl pointer-events-auto bg-background-light dark:bg-background-dark border border-gray-200 dark:border-white/10 focus-within:border-primary dark:focus-within:border-primary-light transition-colors">
<div class="relative flex items-end"><textarea id="chat-assistant-textarea" aria-label="Ask a question..." autoComplete="off" placeholder="Ask a question..." class="chat-assistant-input w-full bg-transparent border-0 peer/input text-gray-900 dark:text-gray- [... 182 characters folded ...]></textarea>
</div>
<div class="flex items-center justify-between px-2 pb-2"><input type="file" accept="image/*,.pdf,.js,.jsx,.ts,.tsx,.mjs,.cjs,.md,.mdx,.json,.html,.css,.py,.csv,.txt,.yaml,.yml,.xml,.sql,.sh,.bash,.zsh,.graphql,.gql,.toml,.env,.go,.rs,.rb,.java,.kt,.swift,.c,.cpp,.cc,.h,.hpp,.c [... 111 characters folded ...]><button type="button" class="p-1 rounded-lg text-gray-500 hover:text-gray-700 dark:text-gray-400 dark:hover:text-gray-200 hover:bg-gray-100 dark:hover:bg-white/10" aria-label="Add attachment">
<svg aria-hidden="true" width="18" height="18" stroke-width="1.5" focusable="false" class="size-3.5 shrink-0"><use href="#mi-mint-1-Attach"></use>
</svg></button><button class="chat-assistant-send-button flex justify-center items-center rounded-full p-1 size-6 bg-primary/30 dark:bg-primary-dark/30" aria-label="Send message" disabled="">
<svg aria-hidden="true" width="18" height="18" stroke-width="2" class="size-2.5 shrink-0 text-white dark:text-white"><use href="#mi-mint-1-Send"></use>
</svg></button>
</div>
</div>
</div>
</div>
</div>
</div>
</div>

Shown with 124 long blocks (scripts, styles, long tags) folded into a marker that says how many characters they hide; line breaks added before block tags because the source is minified; the pane stops after the first 200 words; the page is 218 KB.

Reading view the text a plain-fetch client can extract

title: Overview - Perplexity

No H1 in the initial HTML

Documentation Index Fetch the complete documentation index at: /llms.txt Use this file to discover all available pages before exploring further. Skip to main content Assistant Responses are generated using AI and may contain mistakes. Suggestions What is the Agent API? Which Agent API model should I use? How do I create an API key? For AI agents: see the complete llms.txt documentation index. Perplexity home page Docs Cookbook API Reference Get Started Get Started Search... Navigation Getting Started Overview Search ⌘ K Community Blog Changelog Getting Started Overview Quickstart Pricing Perplexity API MCP Perplexity Computer MCP Perplexity CLI Orchestrator API Quickstart Models Routing & Reliability Agent API Quickstart Building agents Models & Configuration Tools Features OpenAI Compatibility Migrate from Sonar Prompt Guide Search API Overview Quickstart Fast Search Best Practices Search SDK for agents Agent SDKs Filters Embeddings API Quickstart Best Practices Standard Embeddings Contextualized Embeddings Decisions API Quickstart Decider for Mac Perplexity SDK Quickstart Guides Admin & Management Signing In Projects & Billing API Key Management Safety Identifiers Analytics API Audit API Rate Limits & Usage Tiers AWS Marketplace Resources Integrations Feature Requests Privacy & Security Frequently Asked Questions System Status Changelog Get in Touch Perplexity Crawlers Power your

128 more words follow in the initial HTML.

5 found, 1 missing, 1 note, from 7 checks run

  • H1Missing
  • 200 wordsFound
  • llms.txtFound
  • MarkdownFound
  • Missing pathFound
  • JSON-LDFound
  • OpenAPINote
What a plain fetch found on docs.perplexity.ai
CheckResultDetail
H1 in the initial HTMLMissing no H1A plain-fetch client finds no page heading in the bytes it receives.
First 200 words in the initial HTMLFound 200 of 200 wordsThe initial HTML carries 328 words of visible text; the first 200 are marked in the left pane.
llms.txt present and linkedFound present and linked43152 bytes, 191 links. Structure grade A (6 of 6). The home page links it, which is how agents reached it in Ora's lab.
Markdown on requestFound text/markdownAccept: text/markdown returned 200 with text/markdown; charset=utf-8. Vary: Accept is set.
Status of a made-up pathFound 404/agent-ready-html-missing-path-check returned 404: a real status code for a missing page.
JSON-LD typesFound Article, BreadcrumbList, ImageObject, ListItem and 4 more8 schema.org types in JSON-LD blocks on the home page: Article, BreadcrumbList, ImageObject, ListItem, Organization, TechArticle, WebPage, WebSite.
OpenAPI linkNote none on the home pageNo OpenAPI link on the home page. It matters only for a site that ships an API.

Run the full check

The viewer read one page with four requests. The full check we recommend next is Ora's scan. Its Access layer runs 42 checks worth 30 of its 100 points, among them content without JavaScript, bot detection, llms.txt, markdown on request, JSON-LD and the sitemap (Ora's check catalogue, contract 1.38.0, read 5 November 2026). Open Ora's report for docs.perplexity.ai.

Limits: Ora reads public URLs only, says two runs of one scan land within a couple of points without publishing repeat-scan data, and keeps the product that fixes what it finds behind a waitlist. Cloudflare's scanner at isitagentready.com is a quick free alternative, and Mintlify's score covers documentation.

What the viewer does

It sends four plain GET requests with the user agent Mozilla/5.0 (compatible; agent-readiness-crawl/1.0): the URL itself, the same URL with Accept: text/markdown, /llms.txt on the same host, and a made-up path at the root. It runs no JavaScript. The left pane is the first bytes of the HTML as text, with long scripts and styles folded into a marker that says how many characters they hide. The H1 and the first 200 words of visible text are marked in both panes. The flags under the panes say what the four responses added up to.

Limits

  • Ten seconds for all four requests together, 1.5 MB read from the home page, at most five redirects, each one checked again.
  • http and https only, default ports only. Private, local and internal addresses and names are refused.
  • Ten runs per address per minute. The counter lives in memory on the edge function, so it is per instance rather than global. Past ten you get a 429 with a Retry-After header.
  • Results are cached for 24 hours by the response headers. Nothing is written to a database: the viewer keeps the first 200 words and the extracted fields for the length of the request and keeps no page body beyond that.

What it does not tell you

A plain fetch from this server is not a real agent. Bot protection weighs the source address more than the user agent, so a page that answers 200 here can still refuse an agent, and the reverse. Ora's lab found (2026-10-19) that returning 403 to agent user agents and hiding the answer in JavaScript were the only two of 19 configurations that stopped retrieval; the viewer can see the second, and can only hint at the first. The initial HTML reference covers both. The server logs and the published crawler address ranges settle the first.

The seven flags

H1 in the initial HTML
Whether the HTML the server sends already contains an H1. It is the cheapest sign that the page does not depend on scripts to say what it is.
First 200 words in the initial HTML
Whether at least 200 words of visible text arrive in the initial HTML. Under 40 words with an app root element is flagged as a JavaScript shell.
llms.txt present and linked
Whether /llms.txt answers with a plain-text file, whether the home page links it (an anchor, a link element or a Link header), and the structure grade the index uses.
Markdown on request
Whether a request with Accept: text/markdown comes back as text/markdown. Cloudflare Radar found 3.9 percent of scanned top sites passing this at its April 2026 launch.
Status of a made-up path
Whether a path that should not exist returns 404 or 410. A 200 is a soft 404 and reads as a live page.
JSON-LD types
The schema.org types found in JSON-LD blocks on the page. Ora's lab found JSON-LD made no difference when the answer was already in the HTML.
OpenAPI link
Whether the page links an OpenAPI file, by an anchor or a service-desc link relation. It matters only for a site that ships an API.

Sources

  1. Ora: AgentReady launch post (Ora's lab findings) https://ora.ai/blog/agentready-launch, read 4 November 2026
  2. Ora check catalogue, contract 1.38.0 (132 checks, 42 in the Access layer) https://ora.ai/api/checks, read 5 November 2026
  3. Ora home page (the fixing product is behind a waitlist) https://ora.ai/, read 5 November 2026
  4. Ora: Introducing Deep Scan (repeat scans) https://ora.ai/blog/introducing-deep-scan, read 5 November 2026
  5. Ora llms.txt (public URLs only) https://ora.ai/llms.txt, read 5 November 2026
  6. Vercel: Make your site readable by AI agents https://vercel.com/kb/guide/make-your-site-readable-by-ai-agents, read 4 November 2026
  7. llms.txt proposal (llmstxt.org) https://llmstxt.org/, read 4 November 2026

Last reviewed 5 November 2026