Markdown

POST/extract/markdown

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

Body ParametersJSONExpand Collapse

url: string

URL to fetch and convert to markdown

formaturi

effort: optional "min" or "standard" or "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).

One of the following:

"min"

"standard"

"max"

geo_target: optional object { country }

Optional geotargeting parameters for proxy requests

country: optional string

Country code using ISO 3166-1 alpha-2 standard (2 letters, e.g., “US”, “GB”, “JP”). See: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2

metadata: optional boolean

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

nocache: optional boolean

Bypass cache and force fresh data retrieval

ReturnsExpand Collapse

content: string

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

url: string

The URL that was converted to markdown

formaturi

metadata: optional object { author, created_at, creator, 13 more }

Extracted metadata from the page (only included when metadata parameter is true)

author: optional string

Author information from HTML metadata

created_at: optional string

Document creation date (ISO 8601)

creator: optional string

Creator application (e.g., “Microsoft Word”)

description: optional string

Page description from Open Graph or HTML

image: optional string

Featured image URL from Open Graph

formaturi

keywords: optional array of string

PDF keywords as array

modified_at: optional string

Document modification date (ISO 8601)

page_count: optional number

Number of pages (PDF documents)

pdf_version: optional string

PDF version (e.g., “1.5”)

producer: optional string

PDF producer software (e.g., “Adobe PDF Library”)

publisher: optional string

Publisher information from Open Graph

site_name: optional string

Site name from Open Graph

subject: optional string

PDF-specific metadata fields (populated for PDF documents) PDF subject or summary

title: optional string

Page title from Open Graph or HTML

type: optional string

Content type from Open Graph (e.g., article, website)

url: optional string

Canonical URL from Open Graph

formaturi

Markdown

curl https://api.tabstack.ai/v1/extract/markdown \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $TABSTACK_API_KEY" \
    -d '{
          "url": "https://example.com/blog/article",
          "effort": "standard",
          "metadata": true
        }'

{
  "content": "# Example Article Title\n\nThis is the article content converted to markdown...",
  "metadata": {
    "author": "Example Author",
    "description": "This is an example article description",
    "image": "https://example.com/images/article.jpg",
    "publisher": "Example Publisher",
    "site_name": "Example Blog",
    "title": "Example Article Title",
    "type": "article",
    "url": "https://example.com/blog/article"
  },
  "url": "https://example.com/blog/article"
}

{
  "content": "---\ntitle: Example Article Title\ndescription: This is an example article description\nauthor: Example Author\npublisher: Example Publisher\nimage: https://example.com/images/article.jpg\nsite_name: Example Blog\nurl: https://example.com/blog/article\ntype: article\n---\n\n# Example Article Title\n\nThis is the article content converted to markdown...",
  "url": "https://example.com/blog/article"
}

{
  "error": "access to internal resources is not allowed"
}

{
  "error": "url is invalid"
}

{
  "error": "failed to convert HTML to Markdown"
}

{
  "error": "failed to fetch URL"
}

Returns Examples

{
  "content": "# Example Article Title\n\nThis is the article content converted to markdown...",
  "metadata": {
    "author": "Example Author",
    "description": "This is an example article description",
    "image": "https://example.com/images/article.jpg",
    "publisher": "Example Publisher",
    "site_name": "Example Blog",
    "title": "Example Article Title",
    "type": "article",
    "url": "https://example.com/blog/article"
  },
  "url": "https://example.com/blog/article"
}

{
  "content": "---\ntitle: Example Article Title\ndescription: This is an example article description\nauthor: Example Author\npublisher: Example Publisher\nimage: https://example.com/images/article.jpg\nsite_name: Example Blog\nurl: https://example.com/blog/article\ntype: article\n---\n\n# Example Article Title\n\nThis is the article content converted to markdown...",
  "url": "https://example.com/blog/article"
}

{
  "error": "access to internal resources is not allowed"
}

{
  "error": "url is invalid"
}

{
  "error": "failed to convert HTML to Markdown"
}

{
  "error": "failed to fetch URL"
}