## developer api

Any URL to clean Markdown.

One API call turns any web page into LLM-ready Markdown. Built for AI agents, RAG pipelines, and scrapers — fetch, render JavaScript, strip the clutter. You get the content, not the noise.

Get a free key Jump to quickstart

100 conversions/mo free · no card · pay as you go after

## get started

Get a free API key

100 conversions a month, free. No credit card. Your key works instantly.

need higher limits or a paid plan? talk to us

## how it works

A tiered engine that only spends what it must

Fetch

We fetch the URL server-side with a real browser fingerprint and a strict SSRF guard. Static and server-rendered pages stop here.

Render if needed

If a page is a JavaScript shell, we escalate to a headless render — only when the content is too thin, so you never overpay.

Extract

Nav, ads, cookie banners and boilerplate are stripped. You get headings, lists, links, images and code as clean Markdown.

## quickstart

One call, clean Markdown back

curl -X POST https://api.savemarkdown.co/v1/convert \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article"}'

const res = await fetch("https://api.savemarkdown.co/v1/convert", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.SAVE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ url: "https://example.com/article" }),
});
const { markdown, meta } = await res.json();
console.log(markdown); // clean Markdown

import os, requests

res = requests.post(
    "https://api.savemarkdown.co/v1/convert",
    headers={"Authorization": f"Bearer {os.environ['SAVE_API_KEY']}"},
    json={"url": "https://example.com/article"},
)
print(res.json()["markdown"])

Response

{
  "markdown": "📄 Title: Example Article\n🔗 Source: ...\n\n---\n\n## Heading\n\nClean body...",
  "meta": { "tier": 1, "cached": false, "domain": "example.com", "template": "markdown" },
  "usage": { "credits": 1 }
}

## pricing

Pay only for what you convert

No seats, no minimums. Start free with 100 pages, then pay as you go. The response tells you which tier was billed.

tier 1

Markdown

$2 / 1,000 pages

Fetch + clean extraction, no LLM. The fast, cheap default — most pages.

tier 2

Rendered

$8 / 1,000 pages

JavaScript pages rendered headless before extraction. Auto-escalated only when needed.

optional

AI-formatted

$3 / $25 per 1M tokens (in / out)

Premium templates (clean, summary, outline…) via LLM. Token-metered, like the Claude API.

## reference

POST /v1/convert

Authenticate with Authorization: Bearer sk_live_…. Keys are server-side only — never ship one in a browser or app bundle.

url string required

The page to convert. http(s) only.

template string optional

Omit for raw Markdown. Pass an AI template (clean, summary, outline…) for LLM formatting (token-metered).

render "auto" | "never" | "always" optional

JavaScript rendering. Default "auto" escalates to Tier 2 only when a page is a JS shell.

fresh boolean optional

Bypass the 24h cache and refetch.

Walled gardens: YouTube routes through its official transcript API. X / Instagram / TikTok are best-effort. We never use ghost accounts or scrape behind logins.

## built for agents

The web, readable by your agent

LLMs read Markdown, not HTML. Point an agent, a RAG ingest job, or a research loop at any URL and get back tokens worth keeping. This spec is also available as plain Markdown at /api.md. The API is discoverable through our llms.txt, agent-skills index, and API catalog.

## start building

Ship the web as Markdown

Get a free key and convert your first page in under a minute.

Get a free key

free trial · pay as you go · no seats