Expand AI logo
DocsDocs
Glow Active
API Reference
Login

Documentation

Get Started

OverviewWhy ExpandQuickstartWays to Use Expand

Agent Quickstarts

OverviewExpand SkillClaude CodeCursorCodexOpenCodeSkill-Based AgentsOther MCP Clients

Fetch

OverviewHow Fetch WorksOutput ModelInclude OptionsBrowser BehaviorHighlightsPlayground & ReplayBatched Fetch

Reference

API ReferenceCLI CommandsMCP Tools & ResourcesTypeScript SDKPython SDK

Account & Billing

Pricing & UsageTiersFAQ

Machine-Readable Docs

start.mdllms.txtllms-full.txtDocs as Markdown
Browse docs

Get Started

OverviewWhy ExpandQuickstartWays to Use Expand

Agent Quickstarts

OverviewExpand SkillClaude CodeCursorCodexOpenCodeSkill-Based AgentsOther MCP Clients

Fetch

OverviewHow Fetch WorksOutput ModelInclude OptionsBrowser BehaviorHighlightsPlayground & ReplayBatched Fetch

Reference

API ReferenceCLI CommandsMCP Tools & ResourcesTypeScript SDKPython SDK

Account & Billing

Pricing & UsageTiersFAQ

Machine-Readable Docs

start.mdllms.txtllms-full.txtDocs as Markdown

API Reference

Open the generated endpoint reference for Expand APIs.

Exact endpoint contracts for Expand live in the generated API Reference. Open it for exact endpoints, request schemas, response schemas, errors, and rate limits.

Open API Reference

The authored docs on this site explain concepts and tasks. The generated reference at /api-reference is the source of truth for request bodies, response fields, parameter tables, status codes, and generated code samples. When you open it, the left nav switches to the API Reference sidebar instead of mixing endpoint pages into the authored tree.

Generated reference pages

  • Fetch (POST /v1/fetch)
  • Fetch JSON
  • Highlights search
  • Batched Fetch
  • Get batched result
  • Errors
  • Rate limiting
  • Find the endpoint for an authored page

    Each product page maps to a generated endpoint. Use this table to jump from a task to its exact contract.

    Authored pageGenerated reference
    Fetch Overviewfetch.fetch
    Output Modelfetch.fetchJson
    Include Options and

    Highlights is exposed by the /v1/fetch/search endpoint. The product label is Highlights; the technical path keeps its search name.

    Auth header

    Authored cURL examples authenticate with the x-expand-api-key header:

    curl https://api.expand.ai/v1/fetch \
      -H "x-expand-api-key: $EXPAND_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"url":"https://news.ycombinator.com"}'

    SDKs read EXPAND_API_KEY from the environment by default. The generated reference may also document bearer and cookie auth, which are runtime-supported schemes; for task-focused authored examples, keep the API-key header.

    Agent and markdown access

    The API Reference area is available to agents and IDE tools as Markdown:

    • /api-reference.md
    • /api-reference.mdx
    • nested .md and .mdx routes for each endpoint page
    • any request sent with Accept: text/markdown

    Related authored pages

    • CLI Commands
    • MCP Tools & Resources
    • TypeScript SDK
    • Python SDK
    PreviousBatched Fetch
    NextCLI Commands

    On This Page

    Generated reference pagesFind the endpoint for an authored pageAuth headerAgent and markdown accessRelated authored pages
    fetch.fetch
    fetch.fetchJson
    Highlightsfetch.fetchSearch
    Batched Fetchfetch.batched and fetch.getBatched