replynodes-com PDF API

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.