Skip to content
onelayer.
All tools

Tool detail

url2md

Converts a URL (PDF, JavaScript-rendered or plain HTML) to clean Markdown or JSON, paying the target page's own x402 toll if it charges one.

Categories: Web scraping

Use when

  • convert a webpage or PDF to clean Markdown
  • read a JavaScript-rendered page's content as text
  • fetch a page that itself charges an x402 toll, without a separate wallet for it

Not for

  • not for private, loopback or internal hosts - rejected
  • honours the target's robots.txt - may decline disallowed pages

Inputs

POST JSON body: { url: string } (required); format: enum json/markdown (optional); render: enum auto/static/browser (optional, default auto)

Admitted input schema

{
  "type": "object",
  "properties": {
    "format": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "json",
        "markdown"
      ],
      "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."
    },
    "render": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "auto",
        "static",
        "browser"
      ],
      "description": "auto: static first, browser only when the page looks client-rendered. static: never use a browser. browser: always render in a headless browser.",
      "default": "auto"
    },
    "url": {
      "type": "string",
      "minLength": 0,
      "maxLength": 2048,
      "format": "uri",
      "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."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

Endpoint

Method
POST
URL
https://url2md.io/v1/md

Payment

Protocol
x402
Listed price
0.005 USDC per call on Base; pays the target page's own x402 toll, up to 0.05 USDC extra
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
POST https://url2md.io/v1/md
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z