Contents

Get the full page contents, summaries, and metadata for a list of URLs.

Returns instant results from our cache, with automatic live crawling as fallback for uncached pages.

cURL

cURL

curl -X POST https://api.exa.ai/contents \
  -H "x-api-key: $EXA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "urls": [
    "<url>"
  ],
  "highlights": true
}'

200

{
  "requestId": "<string>",
  "results": [
    {
      "title": "<string>",
      "url": "<string>",
      "publishedDate": "2023-11-07T05:31:56Z",
      "author": "<string>",
      "id": "<string>",
      "image": "<string>",
      "favicon": "<string>",
      "text": "<string>",
      "highlights": [
        "<string>"
      ],
      "highlightScores": [
        123
      ],
      "summary": "<string>",
      "subpages": [
        {
          "title": "<string>",
          "url": "<string>",
          "publishedDate": "2023-11-07T05:31:56Z",
          "author": "<string>",
          "id": "<string>",
          "image": "<string>",
          "favicon": "<string>"
        }
      ],
      "entities": [
        {
          "id": "<string>",
          "type": "company",
          "version": 2,
          "properties": {
            "name": "<string>",
            "foundedYear": 123,
            "description": "<string>",
            "workforce": {
              "total": 123
            },
            "headquarters": {
              "address": "<string>",
              "city": "<string>",
              "postalCode": "<string>",
              "country": "<string>"
            },
            "financials": {
              "revenueAnnual": 123,
              "fundingTotal": 123,
              "fundingLatestRound": {
                "name": "<string>",
                "date": "<string>",
                "amount": 123
              }
            },
            "webTraffic": {
              "visitsMonthly": 123,
              "countryRank": 123,
              "avgDurationSeconds": 123,
              "history": [
                {
                  "value": 123,
                  "dateFrom": "<string>",
                  "dateTo": "<string>"
                }
              ]
            },
            "research": {
              "worksCount": 123,
              "citationCount": 123,
              "areas": [
                "<string>"
              ],
              "notableWorks": [
                {
                  "title": "<string>",
                  "year": 123,
                  "venue": "<string>",
                  "citationCount": 123,
                  "doi": "<string>",
                  "id": "<string>",
                  "type": "article"
                }
              ],
              "topResearchers": [
                {
                  "person": {
                    "name": "<string>",
                    "id": "<string>"
                  },
                  "worksCount": 123,
                  "citationCount": 123
                }
              ]
            }
          }
        }
      ],
      "extras": {
        "links": [
          "<string>"
        ],
        "imageLinks": [
          "<string>"
        ],
        "richImageLinks": [
          {
            "url": "<string>",
            "alt": "<string>"
          }
        ],
        "richLinks": [
          {
            "url": "<string>",
            "anchor": "<string>"
          }
        ],
        "codeBlocks": [
          {
            "text": "<string>",
            "source": "<string>"
          }
        ]
      }
    }
  ],
  "statuses": [
    {
      "id": "<string>",
      "status": "success",
      "source": "cached",
      "error": {
        "tag": "<string>",
        "httpStatusCode": 349
      }
    }
  ],
  "costDollars": {
    "total": 123,
    "search": {
      "neural": 123,
      "keyword": 123
    },
    "summary": 123,
    "contents": {
      "text": 123,
      "highlights": 123,
      "summary": 123
    }
  },
  "searchTime": 123,
  "context": "<string>"
}

---

Get your Exa API key

Create a key in the dashboard. New accounts start with free credits.

Authorizations

apiKeybearer

x-api-key · string · header · required

Pass your Exa API key in the x-api-key header. You can also authenticate with Authorization: Bearer .

Body

application/json

Option 1

Option 2

Provide either ids or urls, but not both.

ids · string[] · required

Document IDs obtained from searches.

Required array length: 1 - 100 elements

Required string length: 1 - 2048

urls · string[]

URLs to crawl (backwards compatible with the ids parameter).

Required array length: 1 - 100 elements

Required string length: 1 - 2048

compliance · enum<string> | null

Enterprise-only compliance mode. Set to hipaa for HIPAA mode. Requires cache-only retrieval with supported parameters. See the HIPAA docs for details.

Available options: hipaa

userIdentifier · string | null

An opaque ID your platform assigns to the end user this request is made for, such as a UUID. Lets Exa attribute usage to that end user rather than your whole team. Must not contain personal information such as an email address, phone number, username, or name. Hash such values before sending them. 1 to 64 characters: letters, digits, underscores, and hyphens. Retained even when your team has Zero Data Retention enabled. Does not affect results.

Required string length: 1 - 64

Pattern: ^[A-Za-z0-9_-]+$

Example:

"7f3a9c52-1d4e-4b8a-9e60-2c5d8a1f0b37"

text · boolean Advanced text options · object · default: false

Text extraction options for each result.

highlights · boolean Advanced highlights options · object · default: false

Text snippets the LLM identifies as most relevant from each page.

summary · object | null

Summary of the webpage.

Show child attributes

extras · object | null

Extra parameters to pass.

Show child attributes

livecrawlTimeout · integer | null · default: 10000

The timeout for livecrawling in milliseconds.

Required range: 0 < x <= 90000

maxAgeHours · integer | null

Maximum age of cached content, in hours, up to 720. Cached content younger than this is used, and older pages are fetched fresh. 0 always fetches fresh content and -1 always uses the cache. When omitted, cached content is used when available and pages without it are fetched live.

Required range: -1 <= x <= 720

snapshotAsOf · string<date-time> string<date>

Return the newest stored version of each page as of this instant. Accepts an ISO 8601 date-time (2026-01-15T00:00:00Z) or a date-only value (2026-01-15), which is interpreted as midnight UTC. Historical requests are served from stored versions only and never fetch the live page.

subpages · integer | null · default: 0

The number of subpages to crawl. The actual number crawled may be limited by system constraints.

Required range: 0 <= x <= 100

subpageTarget · string string[]

Term to find specific subpages of search results. Can be a single string or an array of strings.

Required string length: 1 - 100

context · boolean object · deprecated

Deprecated. Use highlights or text instead. Returns page contents as a combined context string.

livecrawl · enum<string> | null · deprecated

Deprecated. Use maxAgeHours instead. Does not guarantee freshly fetched content. Cannot be combined with maxAgeHours.

Available options: never, always, fallback, preferred

crawledBeforeDate · string<date-time> · deprecated

Deprecated. Use snapshotAsOf instead. Alias of snapshotAsOf with identical behavior.

Response

200

application/json

OK

requestId · string

Unique identifier for the request.

results · object[]

Show child attributes

statuses · object[]

Status information for each requested URL or document ID.

Show child attributes

costDollars · object

Estimated dollar cost of the request. Which fields appear depends on the endpoint.

Show child attributes

searchTime · number

Server-side processing time in milliseconds. May exclude output synthesis time, so it can be lower than end-to-end latency.

context · string · deprecated

Deprecated. Use results[].highlights or results[].text instead. Combined context string from search results.