Expand AI logo
DocsDocs
Glow Active
API Reference
Login

Documentation

Get started

IntroductionWhy ExpandQuickstartAuthenticationConnect your agent (MCP)

Products

OverviewFetching a URLBatched Fetch
API reference
IrisX-Ray

SDKs & tools

TypeScript SDK
MCP tools & resourcesDocs for agents

Reference

API referenceErrors & retriesPricing & UsageLimitsConcurrency tiersFAQ
Browse docs

Get started

IntroductionWhy ExpandQuickstartAuthenticationConnect your agent (MCP)

Products

OverviewFetching a URLBatched Fetch
API reference
IrisX-Ray

SDKs & tools

TypeScript SDK
MCP tools & resourcesDocs for agents

Reference

API referenceErrors & retriesPricing & UsageLimitsConcurrency tiersFAQ

Iris

The vision model for browser page Fetches. Iris looks at the rendered page and decides what goes in the Main Markdown, what moves to the Appendix, and what is dropped.

Iris writes the Main Markdown for pages Fetch opens in a browser. It looks at the rendered page, not at the raw HTML, and decides what your agent should read first. There is nothing to switch on for a browser page. Files and YouTube videos use a different conversion path.

Why a model

Other tools turn a page into Markdown with hand-written rules that guess what matters from the HTML. The guesses fail in both directions. A rule that drops a footer removes a company's address on one page, and on the next page it does not fire and ships thousands of tokens of clutter.

Iris does not guess from the HTML alone. It looks at the page the way you do.

What Iris sees

For every element on the rendered page, Iris sees where it sits, how large it is, how bold its text is, whether it is pinned or floating, whether something covers it, and whether it works as navigation or as content.

So a pricing table stays a table, a check mark that means "included" stays a check mark, and a sidebar that looks like navigation is treated as navigation.

What Iris does

Iris sorts every element on the page into one of three groups. Its rule of thumb is that if a reasonable question could be asked about an element, the element stays.

GroupDefinitionWhere it ends up
KeepThe contentThe Main Markdown
AppendixNavigation, sidebars, footers, related linksThe Appendix, one request away
DropAds, cookie banners, promos, share buttonsNowhere. Dropped.

Iris cannot know what your agent will need, so it picks a good default and keeps the rest reachable.

Where Iris shows up

OutputMarkdown textJSON object
The Main MarkdownThe document bodymarkdown
Where a piece of the Appendix was cutA [appendix omitted: 14 links · ~320 tokens] {612} marker in the body. {612} is the evidence ID of the first omitted block.The same marker in markdown

Every line of the Main Markdown links back to the exact spot on the captured page, so you can check what your agent read. See Playground & replay.

How to include the Appendix on each surface is on Include options.

Next steps

  • How Fetch works: where the Main Markdown sits among the other layers.
  • X-Ray: the second model, for the data behind the page.
  • Fetching a URL: the two modes, and what to include.
  • Progressive disclosure: read the Appendix and everything else a Fetch held back.
PreviousPDFs and other files
NextX-Ray

On This Page

Why a modelWhat Iris seesWhat Iris doesWhere Iris shows upNext steps
A pointer to the Appendix
appendix: in the frontmatter, with its url and link counts
meta.appendix
The Appendix itself, with ?include=appendixA ## Appendix section at the endA ## Appendix section at the end of markdown
An evidence ID for citationsThe {612} in each markerjson[].id on State JSON entries, location.evidenceId on Highlights snippets