> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Exa Contents

> Extract full page text, summaries, and metadata for a set of URLs.

Fetch full page contents for a list of URLs (or Exa result ids) passed in `ids`. Choose what comes back with `text` (full page body), `highlights` (relevant snippets), and `summary` (an AI-generated summary), and set `subpages` to also pull linked child pages.

Cached instant results are served first; `livecrawl` controls freshness — `always` forces a live crawl, `fallback` live-crawls only on a cache miss, and `never` returns cached content only. Billed at a flat **\$0.08** per successful request; upstream 4xx responses are not billed. To find the URLs first, start with [`post_exa-search`](/docs/api-reference/search/post_exa-search).


## OpenAPI

````yaml openapi/exa.json POST /exa/contents
openapi: 3.0.0
info:
  title: Exa API
  version: 1.0.0
  description: >-
    Unified API documentation for Exa neural semantic search endpoints exposed
    through the AIsa gateway: Search, Contents, Answer, and the asynchronous
    research Agent Runs.


    Search, Contents, and Answer are synchronous and billed at a flat $0.08 per
    successful request. Agent Runs is asynchronous: the caller submits a run and
    then polls the returned job resource for status and results, billed at a
    flat $0.10 per run. Upstream 4xx responses (for example 401/403/404) are not
    billed. The `costDollars` field that Exa returns is the upstream cost
    breakdown and is informational only — customer billing follows the flat AIsa
    prices above.
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - bearerAuth: []
paths:
  /exa/contents:
    post:
      tags:
        - https://docs.exa.ai/reference/get-contents
      summary: Extract full page contents for a set of URLs.
      description: >-
        Synchronous. Fetch full page text, summaries, and metadata for a list of
        URLs. Cached instant results are served first; on a cache miss Exa falls
        back to a live crawl. Billed at a flat $0.08 per successful request.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                ids:
                  type: array
                  items:
                    type: string
                  description: The URLs (or Exa result ids) to fetch contents for.
                  example:
                    - https://example.com/article
                text:
                  type: boolean
                  description: Return the full page text.
                highlights:
                  type: boolean
                  description: Return highlighted relevant snippets.
                summary:
                  type: boolean
                  description: Return an AI-generated summary of the page.
                subpages:
                  type: integer
                  description: Number of linked subpages to also fetch.
                livecrawl:
                  type: string
                  enum:
                    - always
                    - fallback
                    - never
                  description: >-
                    Freshness policy: always live-crawl, fall back to live crawl
                    on cache miss, or never live-crawl.
              required:
                - ids
      responses:
        '200':
          description: Contents fetched successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  requestId:
                    type: string
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        title:
                          type: string
                        url:
                          type: string
                        publishedDate:
                          type: string
                        author:
                          type: string
                        id:
                          type: string
                        text:
                          type: string
                        highlights:
                          type: array
                          items:
                            type: string
                        summary:
                          type: string
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````