{ "openapi": "3.0.1", "info": { "title": "JPG to PDF Converter - Photos and Scans", "description": "Convert JPG to PDF online in seconds. Upload photos or scans, or paste URLs, and get one multi-page PDF - or a separate PDF per image. Also converts PNG, WebP, TIFF and HEIC. Up to 100 images per run, with page size, margin and quality control.", "version": "0.1", "x-build-id": "caFD1EG6QO9rR8XtH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/marcel-rbro~jpg-to-pdf/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-marcel-rbro-jpg-to-pdf", "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/marcel-rbro~jpg-to-pdf/runs": { "post": { "operationId": "runs-sync-marcel-rbro-jpg-to-pdf", "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/marcel-rbro~jpg-to-pdf/run-sync": { "post": { "operationId": "run-sync-marcel-rbro-jpg-to-pdf", "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": { "files": { "title": "Images", "maxItems": 100, "type": "array", "description": "The images to convert, in the order they should appear in the PDF. Upload files or paste direct URLs. Each image becomes one page. Accepts .jpg, .jpeg, .png, .webp, .tiff, .bmp, .gif, .heic, .heif and .avif." }, "file": { "title": "Single image", "type": "string", "description": "A single image, kept as an alias of the Images field so that existing API callers and saved input configurations keep working. Ignored when Images is filled in." }, "mergeIntoOne": { "title": "Combine into one PDF", "type": "boolean", "description": "On: every image becomes a page of a single PDF, in the order listed. Off: every image becomes its own PDF, and the run returns a ZIP of them. Turn this off when you have 50 photos and want 50 PDFs rather than one 50-page document.", "default": true }, "pageSize": { "title": "Page size", "enum": [ "auto", "a4", "letter", "legal" ], "type": "string", "description": "Auto gives every image a page of its own size, with no cropping and no white bands, which is what you want for scans and screenshots. Choose a fixed size if the PDF is going to be printed.", "default": "auto" }, "orientation": { "title": "Orientation", "enum": [ "auto", "portrait", "landscape" ], "type": "string", "description": "Auto turns each page to match the image on it, so a landscape photo gets a landscape page. Has no effect when the page size is Auto, where the page is the image.", "default": "auto" }, "quality": { "title": "Quality", "minimum": 1, "maximum": 100, "type": "integer", "description": "JPEG compression quality for the images inside the PDF, from 1 to 100. 90 is visually indistinguishable from the original for photos. Set it to 100 to store the images losslessly instead, which is larger but keeps text and line art sharp.", "default": 90 }, "margin": { "title": "Margin", "minimum": 0, "maximum": 288, "type": "integer", "description": "White margin around each image, in points (72 points is one inch). Zero fills the page edge to edge.", "default": 0 }, "outputFilename": { "title": "Output filename", "type": "string", "description": "Name of the resulting file. Defaults to the input filename for a single image, to images.pdf for a combined PDF, and to pdfs.zip for the archive when the images are converted separately." }, "fileBase64": { "title": "File as base64", "type": "string", "description": "Alternative to the file field for API callers: a single source image encoded as base64. Adds about 33% to the payload size." }, "filename": { "title": "Filename for base64 input", "type": "string", "description": "Original filename to use when the image is passed as base64." }, "verboseLog": { "title": "Verbose log", "type": "boolean", "description": "Includes the full ImageMagick output in the Actor log. Useful when a conversion produces odd output.", "default": false } } }, "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 } } }, "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 } } } } } } } } } }