{ "openapi": "3.0.1", "info": { "title": "E-book Converter: Word, Markdown & Google Docs to PDF and EPUB", "description": "Turn a Word (DOCX), Google Docs, Markdown or HTML manuscript into a print-ready PDF and an EPUB e-book with a cover, clickable table of contents and page numbers. For self-publishers, course creators and Amazon KDP. Pay per document.", "version": "0.1", "x-build-id": "QM4sKSn4h6wsBCcfL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/digitalni.produkty.pro.zivot~ebook-converter/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-digitalni.produkty.pro.zivot-ebook-converter", "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/digitalni.produkty.pro.zivot~ebook-converter/runs": { "post": { "operationId": "runs-sync-digitalni.produkty.pro.zivot-ebook-converter", "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/digitalni.produkty.pro.zivot~ebook-converter/run-sync": { "post": { "operationId": "run-sync-digitalni.produkty.pro.zivot-ebook-converter", "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": { "documentUrls": { "title": "Document URLs", "type": "array", "description": "Word (.docx), Markdown (.md), HTML or text files. Google Docs, Google Drive and Dropbox share links work too (the document must be shared as \"anyone with the link\"). One book per URL.", "items": { "type": "string" } }, "text": { "title": "…or paste the text (Markdown)", "type": "string", "description": "Paste the whole book in Markdown or plain text. Use # for the title and ## for chapters." }, "title": { "title": "Title", "type": "string", "description": "Book title. Leave empty to use the first heading of the document." }, "subtitle": { "title": "Subtitle", "type": "string", "description": "Shown on the generated cover." }, "author": { "title": "Author", "type": "string", "description": "Shown on the cover and stored in the PDF and EPUB metadata." }, "language": { "title": "Language", "type": "string", "description": "Language code like en, cs, de, es, fr. Used for hyphenation, the table of contents heading and e-reader metadata.", "default": "en" }, "outputFormats": { "title": "Output formats", "type": "array", "description": "One or both. The price per document is the same.", "items": { "type": "string", "enum": [ "pdf", "epub" ], "enumTitles": [ "PDF (print-ready, with page numbers)", "EPUB (e-readers: Kindle, Kobo, Apple Books)" ] }, "default": [ "pdf", "epub" ] }, "coverImageUrl": { "title": "Cover image URL", "type": "string", "description": "Optional: your own cover (JPEG, PNG or WebP, ideally 1600×2400 px). Leave empty to generate one." }, "generateCover": { "title": "Generate a cover", "type": "boolean", "description": "When there is no cover image, create a clean typographic cover with the title, subtitle and author.", "default": true }, "coverColor": { "title": "Generated cover color", "enum": [ "navy", "forest", "wine", "charcoal", "ocean", "sand" ], "type": "string", "description": "Background color of the generated cover.", "default": "navy" }, "pageSize": { "title": "PDF page size", "enum": [ "A4", "A5", "Letter", "6x9", "5x8" ], "type": "string", "description": "PDF page size", "default": "A4" }, "fontSizePt": { "title": "PDF font size (pt)", "minimum": 8, "maximum": 16, "type": "integer", "description": "Body text size in the PDF.", "default": 11 }, "includeToc": { "title": "Table of contents in the PDF", "type": "boolean", "description": "Clickable table of contents after the cover. The EPUB always has one.", "default": true }, "tocDepth": { "title": "Table of contents depth", "minimum": 1, "maximum": 3, "type": "integer", "description": "1 = chapters only, 2 = chapters and sections, 3 = also subsections.", "default": 2 }, "pageNumbers": { "title": "Page numbers in the PDF", "type": "boolean", "description": "Page numbers at the bottom of each PDF page (not on the cover).", "default": true }, "maxFileSizeMb": { "title": "Maximum document size (MB)", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum document size (MB)", "default": 50 } } }, "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 } } } } } } } } } }