---
title: "MERCURY Cited Markdown"
method: GET
path: "/buy/markdown"
tags: ["cited-markdown", "rag", "rag-ingest", "markdown", "web-to-markdown", "verifiable-web-fetch", "attestation", "provenance", "verifiable-data-record", "llm-ready", "agent-web-fetch", "scraping", "keyless", "agent-native"]
---

# MERCURY Cited Markdown

`GET /buy/markdown`

## Request

- Base URL: `https://network.mercury-hq.com`
- URL: `https://network.mercury-hq.com/buy/markdown`
- Auth: none declared
- TypeScript: <https://skmtc.dev/mercury-hq/apis/mercury-x402-storefront/docs/buy/markdown/get.ts> (a function with typed inputs; its response is checked against the schema)

URL → clean, LLM-ready markdown (boilerplate/nav/ads stripped, headings + lists + links preserved) with a signed provenance receipt pinning the markdown to its source — the RAG-ingest primitive. Deterministic (no LLM): same URL + same source bytes ⇒ byte-identical markdown.

## Query parameters

- `url` string, required: the page to convert to markdown (http/https)

## Response `200`

Delivered after the x402 payment settles on Base mainnet.

- object
  - `ok` boolean, required: true on success; false on an honest failure (503-before-charge)
  - `url` string, required: final URL after redirects
  - `status` integer: upstream HTTP status
  - `text` string: the canonical clean MARKDOWN (the string the signed receipt pins) — boilerplate/nav/ads stripped, headings + lists + links preserved. Identical to data.markdown.
  - `fetchedAt` string: ISO-8601 fetch time (also folded into the signed receipt)
  - `data` object: the structured deliverable the buyer consumes
    - `markdown` string: clean LLM-ready markdown (== text)
    - `title` string: page <title> (HTML pages only)
    - `wordCount` integer: word count of the markdown (for chunk/cost budgeting)
    - `contentType` string
    - `bytes` integer: raw upstream body size
    - `truncated` boolean: true if the markdown hit the 200KB cap
    - `redirects` string[]: redirect chain followed
  - `error` string: present only when ok:false

## Other responses

- `402`: Payment Required — retry with an x402-signed payment (e.g. x402-fetch). Terms are in the challenge body (x402 v1).

---

[API](https://skmtc.dev/mercury-hq/apis/mercury-x402-storefront.md) - [All operations](https://skmtc.dev/mercury-hq/apis/mercury-x402-storefront/llms.txt) - [OpenAPI document](https://skmtc.dev/mercury-hq/apis/mercury-x402-storefront/revisions/211aa7db24ae?raw)