▣ DATA EXTRACTION · DEVELOPER TOOLS

Convert HTML to Markdown API

What it does

HTML to Markdown Converter takes a webpage URL and returns the page content as Markdown. Send an http or https URL in body.url, and you get back the page title, converted markdown, character_count, and a readability_success flag.

Use it when you need clean, developer-friendly text from a live page without building your own scraper and parser. It is useful for turning articles, docs pages, changelogs, and knowledge-base content into Markdown for storage, search indexing, AI pipelines, or internal tooling.

The response is simple to consume: markdown holds the converted content, title gives you the page title, and character_count helps you measure output size. readability_success tells you whether the conversion was able to extract a readable article-style result.

If you are normalizing web content for downstream processing, HTML to Markdown Converter gives you a structured markdown version from a single page URL.

POST

Convert HTML to Markdown

https://api.eu.apyverse.com/chisleroff/convert-html-to-markdown

QUICKSTART

GUIDE

Quickstart

Convert a webpage URL to Markdown with a single POST request.

curl -X POST "https://api.eu.apyverse.com/chisleroff/convert-html-to-markdown" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

What you'll get back

Returns a JSON object with title as a string, markdown as a string, character_count as an integer, and readability_success as a boolean.

{
  "title": "Example Domain",
  "markdown": "# Example Domain\n...",
  "character_count": 1234,
  "readability_success": true
}

TRY ITLIVE · 50 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Converts the HTML content at a webpage URL into Markdown. The response returns the page title, the generated Markdown, the Markdown character count, and a boolean indicating whether readability processing succeeded.

Request Body

Parameter	Type	Mandatory	Description
url	String	Yes	URL of the webpage to convert to Markdown. Must be a valid URI using `http` or `https`, with a maximum length of 2048 characters.

Response

Returns a JSON object with four top-level fields: title as a string, markdown as a string, character_count as an integer, and readability_success as a boolean.

Parameter	Type	Mandatory	Description
title	String	No	The page title.
markdown	String	No	The generated Markdown content.
character_count	Integer	No	The number of characters in the generated Markdown.
readability_success	Boolean	No	Indicates whether readability processing succeeded.

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.