---
title: "Extract content"
method: POST
path: "/extract"
---

# Extract content

`POST /extract`

## Request

- Base URL: `https://www.agentseo.dev/api/v1`
- URL: `https://www.agentseo.dev/api/v1/extract`
- Auth: API key in header `x-api-key`

## Headers

- `x-project-id` string
- `x-workflow-id` string

## Request body

- ExtractParams
  - `url` string, uri, required
  - `format` 'markdown' | 'text' | 'html'
  - `include_images` boolean

## Response `200`

Extracted page with metadata and agent_support

- ExtractResponse
  - `url` string, uri
  - `format` 'markdown' | 'text' | 'html'
  - `content` string
  - `length` integer
  - `sanitized` boolean
  - `metadata` ExtractMetadata
    - `title` string, nullable
    - `meta_description` string, nullable
    - `canonical_url` string, nullable
    - `headings` object
      - `h1` string[]
      - `h2` string[]
      - `h3` string[]
    - `word_count` integer
    - `excerpt` string, nullable
  - `agent_support` ExtractAgentSupport
    - `summary` string
    - `extraction_quality` 'high' | 'medium' | 'low'
    - `notable_sections` string[]
    - `recommended_next_calls` AgentWorkflowNextCall[]
      - `endpoint` string
      - `reason` string
    - `limitations` string[]
    - `confidence` number

## Other responses

- `4XX`: Error

---

[API](https://skmtc.dev/agentseo/apis/agentseo-api.md) · [All operations](https://skmtc.dev/agentseo/apis/agentseo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentseo/apis/agentseo-api/revisions/53a62da6f92c?raw)