Extract

curl --request POST \
  --url https://api.octen.ai/extract \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "urls": [
    "https://octen.ai/",
    "https://docs.octen.ai/api-reference/search"
  ]
}
'

{
  "code": 0,
  "msg": "success",
  "request_id": "req_abc123def456",
  "data": {
    "results": [
      {
        "url": "https://octen.ai/",
        "status": "success",
        "title": "Octen | The Search infrastructure for AI",
        "full_content": "# Search infrastructure for AI\n\nReal-time indexing | Low latency | High reliability\n\nStart Building | View Docs\n\n## Search Beyond Text\n\nBeyond text queries: Octen's multimodal search understands images and videos alongside text...",
        "highlights": null,
        "time_published": null,
        "time_last_crawled": "2026-07-03T09:35:43Z",
        "page_structure": {
          "primary": "Index Page",
          "secondary": "Home Page"
        },
        "category": {
          "primary": "Computers, Electronics & Technology",
          "secondary": "Search Engines"
        },
        "favicon": "https://octen.ai/favicon.ico",
        "cover_image": {
          "url": "https://octen.ai/_next/static/media/octen-cover.dc74905e.png"
        },
        "images": [
          {
            "url": "https://octen.ai/_next/static/media/multi-modal-img.ccffddff.png"
          },
          {
            "url": "https://octen.ai/_next/static/media/showcase-multimodal1.449ae003.png"
          }
        ],
        "videos": [
          {
            "url": "https://octen.ai/static/video/multimodal-video.mp4"
          }
        ]
      },
      {
        "url": "https://docs.octen.ai/api-reference/search",
        "status": "success",
        "title": "Search - Octen",
        "full_content": "# Search API\n\nOcten Search API enables ranked web results with query-focused highlights, time filtering, and multimodal assets...",
        "highlights": null,
        "time_published": "2024-10-15T00:00:00Z",
        "time_last_crawled": "2026-07-03T09:34:29Z",
        "page_structure": {
          "primary": "Content Page",
          "secondary": "Code"
        },
        "category": {
          "primary": "Computers, Electronics & Technology",
          "secondary": "Search Engines"
        },
        "favicon": "https://docs.octen.ai/favicon.ico",
        "cover_image": {
          "url": "https://octen.ai/_next/static/media/octen-cover.dc74905e.png"
        }
      }
    ]
  },
  "meta": {
    "usage": {
      "total_urls": 2,
      "successful_urls": 2
    },
    "latency": 1832,
    "warning": null
  }
}

{
  "code": 400,
  "msg": "Invalid params. urls is required"
}

{
  "code": 401,
  "msg": "Invalid API Key"
}

{
  "code": 403,
  "msg": "Insufficient balance in account"
}

{
  "code": 429,
  "msg": "Exceeding the rate limit"
}

{
  "code": 500,
  "msg": "Internal error"
}

POST

extract

curl --request POST \
  --url https://api.octen.ai/extract \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "urls": [
    "https://octen.ai/",
    "https://docs.octen.ai/api-reference/search"
  ]
}
'

{
  "code": 0,
  "msg": "success",
  "request_id": "req_abc123def456",
  "data": {
    "results": [
      {
        "url": "https://octen.ai/",
        "status": "success",
        "title": "Octen | The Search infrastructure for AI",
        "full_content": "# Search infrastructure for AI\n\nReal-time indexing | Low latency | High reliability\n\nStart Building | View Docs\n\n## Search Beyond Text\n\nBeyond text queries: Octen's multimodal search understands images and videos alongside text...",
        "highlights": null,
        "time_published": null,
        "time_last_crawled": "2026-07-03T09:35:43Z",
        "page_structure": {
          "primary": "Index Page",
          "secondary": "Home Page"
        },
        "category": {
          "primary": "Computers, Electronics & Technology",
          "secondary": "Search Engines"
        },
        "favicon": "https://octen.ai/favicon.ico",
        "cover_image": {
          "url": "https://octen.ai/_next/static/media/octen-cover.dc74905e.png"
        },
        "images": [
          {
            "url": "https://octen.ai/_next/static/media/multi-modal-img.ccffddff.png"
          },
          {
            "url": "https://octen.ai/_next/static/media/showcase-multimodal1.449ae003.png"
          }
        ],
        "videos": [
          {
            "url": "https://octen.ai/static/video/multimodal-video.mp4"
          }
        ]
      },
      {
        "url": "https://docs.octen.ai/api-reference/search",
        "status": "success",
        "title": "Search - Octen",
        "full_content": "# Search API\n\nOcten Search API enables ranked web results with query-focused highlights, time filtering, and multimodal assets...",
        "highlights": null,
        "time_published": "2024-10-15T00:00:00Z",
        "time_last_crawled": "2026-07-03T09:34:29Z",
        "page_structure": {
          "primary": "Content Page",
          "secondary": "Code"
        },
        "category": {
          "primary": "Computers, Electronics & Technology",
          "secondary": "Search Engines"
        },
        "favicon": "https://docs.octen.ai/favicon.ico",
        "cover_image": {
          "url": "https://octen.ai/_next/static/media/octen-cover.dc74905e.png"
        }
      }
    ]
  },
  "meta": {
    "usage": {
      "total_urls": 2,
      "successful_urls": 2
    },
    "latency": 1832,
    "warning": null
  }
}

{
  "code": 400,
  "msg": "Invalid params. urls is required"
}

{
  "code": 401,
  "msg": "Invalid API Key"
}

{
  "code": 403,
  "msg": "Insufficient balance in account"
}

{
  "code": 429,
  "msg": "Exceeding the rate limit"
}

{
  "code": 500,
  "msg": "Internal error"
}

Authorizations

Authorization

string

header

required

Bearer token used for request authentication. Alternatively, you can send the API key in the x-api-key header. Note: A payment method is required to use the API.

Body

application/json

Request body for the Extract API.

urls

string[]

required

List of URLs to extract content from. Maximum URLs per request: 20. Maximum length per URL: 2048. Failed URLs are not billed.

Example:

[
  "https://example.com/article-1",
  "https://example.com/article-2"
]

query

string

Intent-focused keywords. When provided, returns query-relevant highlights per URL; otherwise returns the complete page content.

Maximum string length: 500

max_age_seconds

integer

default:86400

Maximum age (in seconds) of cached content. URLs whose cached version exceeds this threshold will be re-fetched. Values outside the allowed range are adjusted to the nearest bound.

Required range: 300 <= x <= 31536000

format

enum<string>

default:markdown

Format of the returned content.

Available options:

markdown,

text

timeout

integer

default:30

Per-URL extraction timeout in seconds. Values outside the allowed range are adjusted to the nearest bound.

Required range: 1 <= x <= 60

include_images

boolean

default:false

Whether to return image URLs detected on the page.

include_videos

boolean

default:false

Whether to return video URLs detected on the page.

include_audio

boolean

default:false

Whether to return audio URLs detected on the page.

Response

Successful extraction response

code

integer

Business status code. 0 indicates success.

msg

string

A message describing the result.

request_id

string

The unique identifier for this request.

data

object

The main extract response payload.

Show child attributes

APIs

Applications

Authorizations

Body

Response