POST /v1/contents

Contents

Returns the readable text of a public web page.

Try it Markdown

Request body

url: string; Required.A public http(s) URL. Pages that cannot be read return 422 source_not_available; pages that do not exist return 422 page_not_found.
tier: string; auto or flex. flex may take longer to return content.Default: auto
max_characters: integer; Maximum length of the returned text, from 1 to 600,000 characters.Default: 20000
livecrawl: boolean; Fetch the page live instead of using a cached copy.Default: false
livecrawl_timeout_ms: integer; Time limit for the live fetch in milliseconds, from 1,000 to 90,000. Only with livecrawl: true. Defaults to 20,000 for auto and 90,000 for flex.

Response

url: string; Page URL.
title: string; Page title, when available.
published_at: string; Publication time, when available.
image_url: string; Main page image, when available.
content: string; Page text.
truncated: boolean; true when the page is longer than max_characters.
image_urls: string[]; Image URLs found on the page.

See also: Authentication · Errors · Rate limits

Request

curl "https://api.arex-research.com/v1/contents" \
  -H "Authorization: Bearer $AREX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","tier":"auto","max_characters":12000}'

Response200

{
  "url": "https://example.com",
  "title": "Example Domain",
  "content": "# Example Domain\n\nThis domain is for use in illustrative examples.",
  "truncated": false,
  "published_at": "2026-09-03T08:00:00Z",
  "image_url": "https://example.com/image.png",
  "image_urls": []
}

Example response. Actual values vary.