WellMarked

API Documentation

Full reference for the WellMarked URL-to-Markdown API — extract, bulk, crawl, search, usage, keys, and signed webhooks, with Python, JavaScript, TypeScript, and curl examples.

WellMarked is a web-content extraction API. Send a URL, get back clean Markdown stripped of navigation, ads, cookie banners, and boilerplate — plus structured metadata (title, author, date). It is the input layer for anything that needs to read the live web reliably.

When to use it

• Fetch the readable content of a URL as Markdown for an LLM prompt or a vector store.
• Strip a page down to its article body, dropping menus, footers, ads, and tracking scripts.
• Extract structured metadata from a page.
• Process many URLs concurrently in one bulk job — every plan, with Free capped at 5 URLs.
• Crawl a site breadth-first from a root URL and extract every reachable page (Pro and above).
• Render JavaScript-heavy pages before extracting (Pro and above).

Base URL

https://api.wellmarked.io

Authenticated endpoints take a Bearer token. GET /health and GET /pricing are public. An agent with a crypto wallet needs no key at all — see x402 payments.

Quickstart

Get a key

Register at wellmarked.io and copy the key from the response. It starts with wm_ and is returned once — persist it immediately. If you lose it, rotate with POST /keys/rotate rather than starting over.

Extract a page

curlPythonJavaScript

curl -X POST https://api.wellmarked.io/extract \
  -H "Authorization: Bearer wm_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Read the response

{
  "url": "https://example.com",
  "markdown": "# Example Domain\n\nThis domain is for use in…",
  "metadata": { "title": "Example Domain", "author": null, "date": null },
  "metrics": {
    "content_bytes": 84213,
    "input_tokens": 21050,
    "output_tokens": 1204,
    "tokens_saved": 19846,
    "reduction_pct": 94.3
  }
}

tokens_saved is what you did not have to send a model, versus feeding it the raw HTML.

SDKs and integrations

Python

pip install wellmarked — sync and async clients, typed exceptions.

JavaScript / TypeScript

npm install wellmarked — dual ESM + CJS, bundled types.

MCP server

Six tools for agent hosts, local over stdio or hosted over OAuth.

n8n

Official community node — every endpoint as a typed action.

LangChain

Document loader plus a live web-search retriever.

LlamaIndex

Reader for extract, crawl, and search.

Where to go next

Authentication

Bearer keys, scopes, and rotation.

Output formats

markdown, json, chunks, html, links.

Rate limits

Per-second spacing, monthly quota, and headers.

Errors

The envelope, and every code the API can emit.

Authentication

Bearer API keys, the scope model, job tokens, and how to rotate a key without visiting the dashboard.