agentutility(7)$ man pdf2md
/pdf2md
PRICE / CALL
$0.20
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
mediakitCATEGORY
utilities
STATUS
● live
NAME
pdf2md — convert a hosted pdf into clean markdown, html, or structured json by sending its pdf_url
SYNOPSIS
POST https://x402.agentutility.ai/pdf2md
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Convert a hosted PDF into clean Markdown, HTML, or structured JSON by sending its pdf_url. Runs on Datalab's Marker OCR engine, which is layout-aware, so multi-column pages, tables, and equations come out readable instead of scrambled the way naive text extraction leaves them. The response includes the converted output plus page_count and the source URL; PDFs over 30 pages are rejected up front so you know immediately instead of waiting on a doomed job. Use it as a PDF to Markdown converter, PDF OCR API, or document text extraction tool for contracts, papers, and scanned reports.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| pdf_url | string | URL to the source PDF. Rejected if it exceeds 30 pages. | required |
| output_format | string | 'markdown' (default), 'html', or 'json'. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| markdown | string | Markdown content (present when output_format is 'markdown') |
| html | string | HTML content (present when output_format is 'html') |
| json | object | Structured JSON content (present when output_format is 'json') |
| output_format | string | Echo of the format used |
| page_count | number | Number of pages in the source PDF |
| source_url | string | Echo of the input URL |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/pdf2md \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the pdf2md tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- pdfmarkdownhtmljsonconversion
- env
- DATALAB_API_KEY
- methods
- POST
- cluster
- mediakit
- price
- $0.20 USDC per call
ADJACENT — other endpoints in mediakit
| endpoint | description | price |
|---|---|---|
| doc-to-json | Converts any document (PDF, DOCX, PPT, XLSX, or image) into structured JSON matching a caller-supplied schema. | $0.10 |
| extract-tables | Detects and extracts every table from a PDF document, returning structured JSON or CSV per table. | $0.10 |
| pdf-extract-tables | Extracts every table from a PDF, digital or scanned, and returns row-by-column text matrices page-by-page. | $0.10 |
| pdf-table-extract | Extracts tables from digital or scanned PDFs, returning row/column matrices, CSV output, page numbers, and optional cell boxes. | $0.10 |
| pdf-table-extractor | Finds tables in digital or scanned PDFs and returns row-by-column matrices, page numbers, and optional cell bounding boxes. | $0.10 |
| pdf-to-jpg | Convert a PDF into page images for previews, thumbnails, or archiving. | $0.10 |
| speaker-diarize | Transcribe audio or video and label who said what. | $0.10 |
| transcribe | Convert spoken audio or video into text. | $0.10 |
SEE ALSO