agentutility(7)$ man url-to-markdown
/url-to-markdown
PRICE / CALL
$0.005
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
mediakitCATEGORY
uncategorized
STATUS
● live
NAME
url-to-markdown — fetches a public url, strips boilerplate, and returns clean markdown plus title and character counts
synonym alias of html-to-markdown — reuses the canonical handler.
SYNOPSIS
POST https://x402.agentutility.ai/url-to-markdown
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Fetches a public URL, strips boilerplate, and returns clean Markdown plus title and character counts. Use it as a URL to Markdown converter, webpage to Markdown tool, or article cleanup API for pulling readable text out of blog posts, docs pages, and news articles before feeding them to an LLM. Send a url; get back source_url, title, markdown, markdown_chars, and html_chars so you can gauge how much boilerplate got trimmed.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| html | string | Raw HTML to convert. Mutually exclusive with 'url' — supply one. | optional |
| url | string | Page URL to fetch and convert. Server follows redirects. Mutually exclusive with 'html'. | optional |
| include_links | boolean | Keep hyperlinks as Markdown [text](href). Default true. Set false for prose-only output. | optional |
| include_images | boolean | Keep images as Markdown . Default true. | optional |
| user_agent | string | Optional User-Agent header sent when fetching 'url'. Default is a generic browser UA. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| source_url | string | — |
| title | string | — |
| markdown | string | — |
| markdown_chars | string | — |
| html_chars | string | — |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/url-to-markdown \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the url-to-markdown tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- mediakiturltomarkdownurl-to-markdown
- methods
- POST
- cluster
- mediakit
- price
- $0.005 USDC per call
ADJACENT — other endpoints in mediakit
| endpoint | description | price |
|---|---|---|
| compress-pdf | Shrink a PDF's file size without manually tuning compression settings. | $0.005 |
| convert-html-to-markdown | Convert HTML to Markdown. | $0.005 |
| excel-to-csv | Converts Excel workbooks (.xlsx / .xls) to CSV, TSV, or JSON with multi-sheet handling, returning each sheet by name. | $0.005 |
| excel-to-google-sheets | Converts Excel files for import into Google Sheets. | $0.005 |
| html-markdown | Converts raw HTML or a URL into clean Markdown, preserving headings, lists, tables, code blocks, links, and images. | $0.005 |
| html-to-markdown | Convert HTML to Markdown. | $0.005 |
| json-yaml | Converts between JSON and YAML in either direction. | $0.005 |
| pdf-compress | Shrinks PDFs to a smaller size for email or the web, with three quality levels: ebook (lowest, web-quality), printer (medium), prepress (… | $0.005 |
SEE ALSO