{ "openapi": "3.0.1", "info": { "title": "PDF Tools: merge, split, compress and rotate PDFs", "description": "Merges PDFs you link or store into one file, splits each PDF by page ranges or every N pages, compresses PDFs with optional image recompression, or rotates the pages you pick. Opens password protected PDFs. Returns a download link for every PDF it writes.", "version": "0.1", "x-build-id": "a0U4UTH98SxMW1O7d" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/examsens.ai~pdf-tools/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-examsens.ai-pdf-tools", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/examsens.ai~pdf-tools/runs": { "post": { "operationId": "runs-sync-examsens.ai-pdf-tools", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/examsens.ai~pdf-tools/run-sync": { "post": { "operationId": "run-sync-examsens.ai-pdf-tools", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "operation": { "title": "Operation", "enum": [ "merge", "split", "compress", "rotate" ], "type": "string", "description": "Merge: join every PDF into one file in your order. Split: cut each PDF into parts. Compress: make each PDF smaller. Rotate: turn the pages you pick in each PDF.", "default": "merge" }, "pdfUrls": { "title": "PDF URLs", "type": "array", "description": "Direct links to PDF files. Merge keeps this order.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "inputStore": { "title": "Files in a key value store", "type": "string", "description": "To use PDFs from your computer, upload them to one of your key value stores, then pick that store here. Every record whose key ends in .pdf is processed in key order, or only the keys you list below in your order." }, "inputKeys": { "title": "Record keys", "type": "array", "description": "Only process these records from the store above, in this order, one key per line.", "items": { "type": "string" } }, "pages": { "title": "Pages (merge and rotate)", "type": "string", "description": "Merge: the pages taken from every PDF. Rotate: the pages to turn. Forms such as 1-3, 5, 8- (8- runs to the last page). Empty means every page." }, "splitRanges": { "title": "Split ranges", "type": "string", "description": "One part per group, groups split by semicolons: 1-3; 4-6; 7- gives three PDFs. A group can list pages, such as 1, 3, 5. Empty splits every N pages, set below." }, "splitEvery": { "title": "Split every N pages", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Used when Split ranges is empty. 1 gives one PDF per page.", "default": 1 }, "rotateDegrees": { "title": "Rotate by", "enum": [ "90", "180", "270" ], "type": "string", "description": "Clockwise turn for the pages you pick.", "default": "90" }, "imageQuality": { "title": "Image quality (compress)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Recompress photos in the PDF as JPEG at this quality, from 1 to 100. An image is replaced only when the new one is smaller. 0 leaves images as they are, so only the page content and structure are compressed.", "default": 0 }, "imageMaxPixels": { "title": "Maximum image size in pixels (compress)", "minimum": 0, "maximum": 20000, "type": "integer", "description": "Scale down images whose longest side is over this, such as 1600. 0 keeps their size.", "default": 0 }, "stripMetadata": { "title": "Remove document properties (compress)", "type": "boolean", "description": "Remove the title, author, creator and dates from the PDF properties.", "default": false }, "password": { "title": "PDF password", "type": "string", "description": "Password to open protected PDFs. The same password is tried on every PDF. The files written are not password protected." }, "outputName": { "title": "Merged file name", "type": "string", "description": "Name of the merged PDF.", "default": "merged" }, "maxFileSizeMb": { "title": "Maximum file size (MB)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Larger PDFs are skipped with an error item and are not charged.", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }