$ man compress-pdf
/compress-pdf(1)
PRICE / CALL
$0.005
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
mediakitCATEGORY
media
STATUS
● live
NAME
compress-pdf — pdf compressor / pdf size reducer
SYNOPSIS
POST https://x402.org/v1/compress-pdf
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
PDF compressor / PDF size reducer. CloudConvert optimize task. Profiles: web (default), print, archive, mrc (scanned), max. Reports % saved.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| pdf_url | string | Public URL of the PDF to compress. | required |
| profile | string | 'web' (default), 'print', 'archive', 'mrc', 'max'. enum: web · print · archive · mrc · max | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| pdf_url | string | Signed URL to download the compressed PDF output. |
| original_size_bytes | number | Byte size of the source PDF before compression. |
| compressed_size_bytes | number | Byte size of the output PDF after CloudConvert optimization. |
| saved_percent | number | Percent reduction in file size from original to compressed. |
| profile | string | Optimization profile applied: web, print, archive, mrc, or max. |
| source_url | string | Echo of the input PDF URL that was compressed. |
| job_id | string | CloudConvert job identifier for the optimize task. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/compress-pdf \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# install once claude mcp add x402 --command "npx x402-deployer-mcp" # then ask Claude Code: # "use the compress-pdf tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- pdfcompressoptimizeshrink
- env
- CLOUD_CONVERT_API_KEY
- methods
- POST
- cluster
- mediakit
- price
- $0.005 USDC per call
ADJACENT — other endpoints in mediakit
| endpoint | description | price |
|---|---|---|
| convert-html-to-markdown | Convert HTML to Markdown. | $0.005 |
| excel-to-csv | Excel (.xlsx / .xls) → CSV / TSV / JSON converter. | $0.005 |
| excel-to-google-sheets | Convert Excel to Google Sheets / XLSX to Google Sheets / spreadsheet import / Numbers to Google Sheets / Excel to gsheet. | $0.005 |
| html-to-markdown | HTML → Markdown converter. | $0.005 |
| pdf-compress | PDF compressor / shrink PDF / PDF size reducer / smaller PDF for email. | $0.005 |
| xlsx-to-csv | Excel to CSV / XLSX to CSV / Numbers to CSV / spreadsheet to CSV. | $0.005 |
| json-yaml | JSON ↔ YAML bidirectional converter. | $0.002 |
| audio-transcribe | Audio transcribe / speech-to-text / Whisper-large / multi-language ASR / OpenAI Whisper API compat. | $0.01 |
SEE ALSO