v7

latestOpenAPI 3.0.3raw.githubusercontent.com2026-05-056151218.0 KB

Extract

Markdown

Fetches a URL and converts its HTML content to clean Markdown format with optional metadata extraction

post/extract/markdown

Request body

effort'min' | 'standard' | 'max'

Fetch effort level controlling speed vs. capability tradeoff. "min": fastest, no fallback (1-5s). "standard": balanced with enhanced reliability (default, 3-15s). "max": full browser rendering for JS-heavy sites (15-60s).

metadataboolean

Include extracted metadata (Open Graph and HTML metadata) as a separate field in the response

nocacheboolean

Bypass cache and force fresh data retrieval

urlstring uri required

URL to fetch and convert to markdown

Example request

{
  "effort": "standard",
  "geo_target": {
    "country": "US"
  },
  "metadata": true,
  "url": "https://example.com/blog/article"
}

Response

contentstring required

The markdown content (includes metadata as YAML frontmatter by default)

urlstring uri required

The URL that was converted to markdown

Example response

{
  "content": "# Example Article Title\n\nThis is the article content converted to markdown...",
  "metadata": {
    "author": "Example Author",
    "created_at": "2024-01-15T10:30:00Z",
    "creator": "Microsoft Word",
    "description": "This is an example article description",
    "image": "https://example.com/images/article.jpg",
    "keywords": [
      "keyword1",
      "keyword2"
    ],
    "modified_at": "2024-01-20T15:45:00Z",
    "page_count": 42,
    "pdf_version": "1.5",
    "producer": "Adobe PDF Library 15.0",
    "publisher": "Example Publisher",
    "site_name": "Example Blog",
    "subject": "Document subject",
    "title": "Example Article Title",
    "type": "article",
    "url": "https://example.com/blog/article"
  },
  "url": "https://example.com/blog/article"
}