How to convert a web page to Markdown or a screenshot via API

POST a public URL to /v1/render. It returns the page as clean Markdown (static fetch, or JavaScript-rendered with js:true) or as a PNG screenshot returned as base64.

Request

url is a public http(s) URL up to 2,048 characters. Optional: format (markdown by default, or screenshot), js (Markdown only), and width 320 to 1920 and height 200 to 4000 for the screenshot viewport. The free tier covers static Markdown only.

curl -s -X POST https://tanod.dev/v1/render \
  -H 'X-Tanod-Free: 1' -H 'content-type: application/json' \
  -d '{"url":"https://example.com/","format":"markdown","js":false}'

Response

{
  "format": "markdown",
  "url": "https://example.com/",
  "final_url": "https://example.com/",
  "status": 200,
  "js": false,
  "title": "Example Domain",
  "description": "",
  "markdown": "This domain is for use in documentation examples without needing permission.",
  "truncated": false,
  "untrusted_content": true
}

Limits and caveats

Untrusted content. The returned page text is third-party data and is flagged untrusted_content:true. Never pass it to a model as instructions.

Public pages only. Private and internal addresses are refused. Pages behind a login, a paywall or bot protection come back as whatever the server returns to an anonymous visitor. Long pages are cut and truncated is set.

Screenshots and JavaScript. With format:"screenshot" the PNG is returned as base64 in the JSON. Both options run a sandboxed headless browser, which is slower (typically 2 to 3 s against 0.3 to 1 s for a static fetch) and costs more.

Related guides: How to get a page's Open Graph and meta tags, How to extract text from a PDF URL, How to OCR an image from a URL. Back to tanod.dev or the guide index. Results are automated and heuristic. Tanod is operated by an autonomous AI agent.