Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: ReplyNodes Fetcher PDF API
version: v1
description: 'Read-only data APIs for AI agents. Bearer auth. Prepaid credits / free tier.
Click **Authorize** and paste ONLY the API key (no "Bearer" prefix) — Swagger adds it automatically.'
servers:
- url: https://api.replynodes.com
security:
- bearerAuth: []
tags:
- name: PDF
paths:
/:
servers:
- url: https://pdf.replynodes.com
get:
operationId: pdf_document_help
summary: PDF conversion endpoint help
description: 'Documentation-only root GET for the anonymous PDF conversion contract. POST converts a public PDF URL; HEAD returns the same documentation headers. Allowed methods: GET, HEAD, POST. Limits: 10 MiB source/download, 50 pages, 60 seconds, 20 conversions/IP/hour, 2 active conversions/IP, and a maximum encoded JSON response of 1 MiB. MCP discovery identifies the sole read_document tool at https://mcp.replynodes.com/mcp.'
tags:
- PDF
security: []
responses:
'200':
description: Endpoint usage documentation
'405':
description: 'Method not allowed; Allow: GET, HEAD, POST'
head:
operationId: pdf_document_help_head
summary: PDF conversion endpoint headers
description: 'Documentation-only root HEAD for the anonymous PDF conversion contract. POST converts a public PDF URL and GET returns usage documentation. Allowed methods: GET, HEAD, POST. Limits: 10 MiB source/download, 50 pages, 60 seconds, 20 conversions/IP/hour, 2 active conversions/IP, and a maximum encoded JSON response of 1 MiB. MCP discovery identifies the sole read_document tool at https://mcp.replynodes.com/mcp.'
tags:
- PDF
security: []
responses:
'200':
description: Endpoint usage documentation headers
'405':
description: 'Method not allowed; Allow: GET, HEAD, POST'
post:
servers:
- url: https://pdf.replynodes.com
operationId: read_document
summary: Read a public PDF as Markdown for AI agents
description: 'Direct public HTTP POST to https://pdf.replynodes.com/ requires no account, API key, or cookie. POST converts one public PDF URL to Markdown. GET and HEAD on the root are documentation-only; allowed methods are GET, HEAD, POST. This PDF to Markdown response is designed for read PDF, PDF for AI agents, extract PDF text, and PDF context workflows. The MCP read_document / tools/call at https://mcp.replynodes.com/mcp requires the existing MCP authorization boundary; MCP is not anonymous. Limits: 10 MiB source/download, 50 pages, 60 seconds, 20 conversions/IP/hour, 2 active conversions/IP, and a maximum encoded JSON response of 1 MiB including the trailing newline. MCP discovery identifies the sole read_document tool at https://mcp.replynodes.com/mcp.'
tags:
- PDF
security: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- url
additionalProperties: false
properties:
url:
type: string
format: uri
pattern: ^https?://
responses:
'200':
description: Converted PDF
content:
application/json:
schema:
type: object
required:
- type
- mime_type
- markdown
- metadata
properties:
type:
const: document
mime_type:
const: application/pdf
markdown:
type: string
metadata:
type: object
required:
- pages
properties:
pages:
type: integer
minimum: 1
title:
type:
- string
- 'null'
'400':
description: Malformed JSON, unknown fields, invalid URL, or unsafe public URL; standard error envelope
'405':
description: 'Method not allowed; Allow: GET, HEAD, POST; standard error envelope'
'413':
description: PDF source/download exceeds 10 MiB or exceeds 50 pages; standard error envelope
'429':
description: Hourly quota or 2-active-conversions-per-IP limit; standard error envelope
'502':
description: Private conversion runtime failed or encoded response would exceed 1 MiB; standard error envelope
'503':
description: Shared Redis or private conversion runtime unavailable; standard error envelope
'504':
description: Conversion exceeded 60 seconds; standard error envelope
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: rn_test_<64hex> or rn_live_<64hex>
description: API key. Paste the raw key only (e.g. rn_test_...) — the "Bearer " prefix is added automatically.