Inspect, check, split, merge, extract pages, rotate, linearize, optimize, strip

Inspect, check, split, merge, extract pages, rotate, linearize, optimize, strip metadata, encrypt, decrypt or repair PDFs from public HTTPS URLs. POST /v1/pdf with operation, input_urls and options. Answers JSON: document facts, and for transforms temporary HTTPS URLs to the result PDFs, kept one hour. Up to 50 MB per input. Pay per request in USDC; no account, no API key.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://agent.pocket.network/v1/pdf-tools

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "input_urls": [
      "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf"
    ],
    "operation": "inspect",
    "options": {}
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "description": "The JSON body of POST /v1/pdf. Each operation's options schema is in the OpenAPI document the backend serves at /openapi.json. Limits: 50 MB per input, 100 MB in total, 500 combined pages.",
          "properties": {
            "input_urls": {
              "description": "Public HTTPS PDFs on port 443. merge takes 2 to 10; every other operation takes exactly one.",
              "examples": [
                [
                  "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf"
                ]
              ],
              "items": {
                "maxLength": 2048,
                "pattern": "^https://",
                "type": "string"
              },
              "maxItems": 10,
              "minItems": 1,
              "type": "array"
            },
            "operation": {
              "description": "What to do with the PDF.",
              "enum": [
                "inspect",
                "check",
                "split",
                "merge",
                "extract_pages",
                "rotate",
                "linearize",
                "optimize_structure",
                "remove_metadata",
                "encrypt",
                "decrypt",
                "repair"
              ],
              "type": "string"
            },
            "options": {
              "description": "The operation's options. extract_pages needs {pages}; rotate needs {angle: 90, 180 or 270} and takes pages; split takes pages_per_file; encrypt needs owner_password and user_password (8 to 127 bytes, AES-256). Any operation takes password for an encrypted input; merge takes passwords, one per input.",
              "type": "object"
            }
          },
          "required": [
            "operation",
            "input_urls"
          ],
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST",
            "PUT",
            "PATCH"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "data": {
              "description": "A JSON object with ok, service, operation, data, outputs and notes. data carries the document facts (page_count, pdf_version, encrypted, linearized, structurally_valid, ...); outputs lists each result PDF with url, bytes, page_count and expires_at. A refused request answers ok false with error.code and error.message, e.g. unsafe_url.",
              "type": "object"
            },
            "portal": {
              "properties": {
                "provenance": {
                  "const": "third-party-supplier"
                },
                "schemaCheck": {
                  "enum": [
                    "passed",
                    "undeclared",
                    "unchecked"
                  ]
                },
                "serviceId": {
                  "const": "pdf-tools"
                }
              },
              "required": [
                "provenance",
                "serviceId",
                "schemaCheck"
              ],
              "type": "object"
            }
          },
          "required": [
            "portal",
            "data"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON