{
"openapi": "3.0.1",
"info": {
"title": "PDF to Markdown Converter: Word, PPTX, Excel & EPUB",
"description": "Convert PDF, Word (DOCX), PowerPoint (PPTX), Excel (XLSX), HTML and EPUB files from URLs or uploads to Markdown, plain text or RAG chunks with page numbers. Tables become Markdown tables; scanned PDFs are OCR'd. No API key or LLM. $4 per 1,000 documents.",
"version": "0.1",
"x-build-id": "BAvdM2ZbY77rpfO09"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/cprussin~document-to-markdown/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-cprussin-document-to-markdown",
"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/cprussin~document-to-markdown/runs": {
"post": {
"operationId": "runs-sync-cprussin-document-to-markdown",
"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/cprussin~document-to-markdown/run-sync": {
"post": {
"operationId": "run-sync-cprussin-document-to-markdown",
"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": {
"urls": {
"title": "Document URLs",
"type": "array",
"description": "Links to PDF, DOCX, PPTX, XLSX, HTML, EPUB, CSV or TXT files, one per line. The type is detected from the file itself, so links without an extension work too. Apify key-value store record URLs (api.apify.com/v2/key-value-stores/.../records/...) are read with your token. Each converted document is billed once; failed ones are free.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "Optional alternative to Document URLs, in Apify's request-list format (e.g. a file with one URL per line, or the output of another actor). Combined with Document URLs.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"keyValueStoreRecords": {
"title": "Key-value store records",
"type": "array",
"description": "Files uploaded to an Apify key-value store, as storeId/recordKey or username~store-name/recordKey, one per line. Use this to convert your own files without hosting them anywhere.",
"items": {
"type": "string"
}
},
"outputFormat": {
"title": "Output format",
"enum": [
"markdown",
"text",
"chunks"
],
"type": "string",
"description": "Markdown: one item per document, with headings, lists and Markdown tables. Plain text: the same without Markdown syntax (table cells tab-separated). RAG chunks: one item per chunk, with page numbers and the nearest heading, ready for a vector database.",
"default": "markdown"
},
"chunkSize": {
"title": "Chunk size (characters)",
"minimum": 200,
"maximum": 20000,
"type": "integer",
"description": "RAG chunks only. Maximum characters per chunk, overlap included. Chunks break between paragraphs; long tables are split by rows and repeat their header. About 4 characters make one token.",
"default": 2000
},
"chunkOverlap": {
"title": "Chunk overlap (characters)",
"minimum": 0,
"maximum": 10000,
"type": "integer",
"description": "RAG chunks only. Characters repeated from the end of the previous chunk, at most half the chunk size. 0 for none.",
"default": 200
},
"ocr": {
"title": "OCR scanned pages",
"type": "boolean",
"description": "Read PDF pages that have no text layer (scans, photos) with Tesseract OCR. Pages with text are never OCR'd. Each OCR'd page is billed as an extra event.",
"default": true
},
"ocrLanguage": {
"title": "OCR language",
"enum": [
"eng",
"deu",
"fra",
"spa",
"ita",
"por",
"nld"
],
"type": "string",
"description": "Language of the scanned text.",
"default": "eng"
},
"maxOcrPagesPerDocument": {
"title": "Max OCR pages per document",
"minimum": 0,
"maximum": 2000,
"type": "integer",
"description": "Caps OCR cost and time per document. Scanned pages beyond the cap are skipped (and reported in the item's warning).",
"default": 50
},
"maxFileSizeMb": {
"title": "Max file size (MB)",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "Larger files are skipped with an error (free). Raise the run's memory for files over 50 MB.",
"default": 50
},
"maxPagesPerDocument": {
"title": "Max PDF pages per document",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Only the first pages of longer PDFs are converted (noted in the item's warning).",
"default": 1000
},
"timeoutSecs": {
"title": "Download timeout (seconds)",
"minimum": 5,
"maximum": 600,
"type": "integer",
"description": "Max time to download one file.",
"default": 60
},
"maxConcurrency": {
"title": "Parallel downloads",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "Files downloaded at the same time. Conversion runs one document at a time to keep memory low.",
"default": 3
}
}
},
"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
}
}
}
}
}
}
}
}
}
}