PDFs, JavaScript pages and ordinary HTML as clean Markdown
PDFs, JavaScript pages and ordinary HTML as clean Markdown. Pays a page's x402 toll for you. Follows robots.txt.
5000 (raw units)
price
43
calls / 30d
4
unique payers
2026-09-18
updated
Provider
url2md.io · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0xa09aE66Ec8664475697FfC0eb45aa3Fe52Aa6030",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "5000",
"maxTimeoutSeconds": 120
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"body": {
"format": "json",
"render": "auto",
"url": "https://example.com"
},
"bodyType": "json",
"method": "POST",
"type": "http"
},
"output": {
"example": {
"canonical": null,
"charset": "utf-8",
"contentSignal": null,
"contentType": "text/html",
"description": null,
"fetchedAt": "2026-09-06T03:45:14.033Z",
"finalUrl": "https://example.com/",
"lang": null,
"markdown": "# Example Domain\n\nThis domain is for use in documentation examples without needing permission. Avoid use in operations.\n\n[Learn more](https://iana.org/domains/example)",
"redirects": [],
"render": {
"escalated": false,
"mode": "auto",
"reasons": []
},
"source": "static",
"timing": {
"browserMsUsed": null,
"convertMs": 3,
"fetchMs": 268,
"renderMs": null,
"totalMs": 412
},
"title": "Example Domain",
"tokensEstimate": 42,
"url": "https://example.com",
"warnings": [],
"words": 24
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"properties": {
"format": {
"description": "json: the whole result object. markdown: the markdown body alone, sent as text/markdown. Omit it and the format follows the Accept header (text/markdown → markdown), else json.",
"enum": [
"json",
"markdown"
],
"type": "string"
},
"render": {
"default": "auto",
"description": "auto: static first, browser only when the page looks client-rendered. static: never use a browser. browser: always render in a headless browser.",
"enum": [
"auto",
"static",
"browser"
],
"type": "string"
},
"url": {
"description": "Absolute http(s) URL to convert; percent-encode it in the query string. http and https only, no credentials in the URL, no private, loopback or internal hosts, and the port must be one Cloudflare proxies (80, 443, 8080, 8443, 8880, 2052/2053/2082/2083/2086/2087/2095/2096). robots.txt is honoured for the user-agent token url2md.",
"format": "uri",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"url"
]
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"description": "The conversion result. The same metadata always travels in response headers as well, so a caller that asked for text/markdown still gets it: X-Url2md-Source (static | browser | pdf | origin-markdown | text), X-Url2md-Final-Url, X-Url2md-Title (percent-encoded), X-Url2md-Words, X-Url2md-Tokens-Estimate, X-Url2md-Ledger-Id (the ledger row for the settled payment), and X-Url2md-Upstream-Toll (USD paid to the origin when the page itself charged an x402 toll, absent otherwise). The x402 settlement receipt is in PAYMENT-RESPONSE. Errors are JSON with a stable error.code, and any error after a charge carries error.details.callerCharged with the ledger id.",
"properties": {
"blockSuspected": {
"description": "set when what came back looks like a bot challenge or block page rather than the page: the origin answered 200 and the call was charged, but the content is probably not what was asked for. Also sent as X-Url2md-Block-Suspected, and named in warnings[].",
"properties": {
"markers": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": [
"object",
"null"
]
},
"canonical": {
"type": [
"string",
"null"
]
},
"charset": {
"type": [
"string",
"null"
]
},
"contentSignal": {
"description": "Upstream Content-Signal header, passed through untouched",
"type": [
"string",
"null"
]
},
"contentType": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"fetchedAt": {
"format": "date-time",
"type": "string"
},
"finalUrl": {
"description": "the URL after redirects; also sent as X-Url2md-Final-Url",
"type": "string"
},
"lang": {
"type": [
"string",
"null"
]
},
"markdown": {
"description": "the converted page",
"type": "string"
},
"redirects": {
"items": {
"properties": {
"from": {
"type": "string"
},
"status": {
"type": "integer"
},
"to": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"render": {
"properties": {
"escalated": {
"type": "boolean"
},
"mode": {
"enum": [
"auto",
"static",
"browser"
],
"type": "string"
},
"reasons": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"source": {
"description": "how the markdown was produced; also sent as X-Url2md-Source",
"enum": [
"static",
"browser",
"pdf",
"origin-markdown",
"text"
],
"type": "string"
},
"timing": {
"properties": {
"browserMsUsed": {
"type": [
"integer",
"null"
]
},
"convertMs": {
"type": "integer"
},
"fetchMs": {
"type": "integer"
},
"renderMs": {
"type": [
"integer",
"null"
]
},
"totalMs": {
"type": "integer"
}
},
"type": "object"
},
"title": {
"description": "also sent percent-encoded as X-Url2md-Title",
"type": [
"string",
"null"
]
},
"tokensEstimate": {
"description": "also sent as X-Url2md-Tokens-Estimate",
"type": "integer"
},
"url": {
"description": "the URL as asked for",
"type": "string"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
},
"words": {
"description": "also sent as X-Url2md-Words",
"type": "integer"
}
},
"required": [
"url",
"finalUrl",
"source",
"markdown",
"words",
"tokensEstimate",
"fetchedAt",
"timing",
"render",
"warnings"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
}
}Use it
curl
curl "https://url2md.io/v1/md" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://url2md.io/v1/md");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://url2md.io/v1/md")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/6744.json, and this resource appears in /discovery/resources and /discovery/search.