{ "openapi": "3.0.1", "info": { "title": "PDF & Document to Markdown and Text: PDF, DOCX, PPTX, HTML", "description": "Convert PDFs, Word, PowerPoint, Excel, CSV, text files and web pages from URLs into clean Markdown and plain text for LLMs, RAG and AI agents. Headings, lists, tables, metadata, page splits, scanned-PDF detection. $1 per 1,000 documents + $0.10 per 1,000 PDF pages.", "version": "1.0", "x-build-id": "bxHhVj4bnBGV16DuY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fairfetch~document-to-markdown/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fairfetch-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/fairfetch~document-to-markdown/runs": { "post": { "operationId": "runs-sync-fairfetch-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/fairfetch~document-to-markdown/run-sync": { "post": { "operationId": "run-sync-fairfetch-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": "Direct links to documents: PDF, Word (.docx, .docm), PowerPoint (.pptx, .ppsx), Excel (.xlsx, .xlsm), CSV / TSV, plain text, Markdown, or any web page (its main content is extracted). The real file type is detected from the content, so links without a file extension work too. GitHub, GitLab, Dropbox and Google Drive / Docs viewer links are rewritten to the file itself. One row per document is returned.", "items": { "type": "string" } }, "keyValueStore": { "title": "Key-value store with files", "type": "string", "description": "Optional: convert files you uploaded to one of your key-value stores (every record, or only the keys below). Apify grants this run read access to the store you select." }, "keyValueStoreKeys": { "title": "Record keys", "type": "array", "description": "Optional: only these records of the selected key-value store (default: all records except INPUT and SUMMARY, up to 1,000).", "items": { "type": "string" } }, "outputFormat": { "title": "Output format", "enum": [ "markdown", "text", "both" ], "type": "string", "description": "\"markdown\" (headings, lists, tables; best for LLMs and RAG), \"text\" (plain text, tables as tab-separated rows) or \"both\".", "default": "markdown" }, "splitPages": { "title": "One row per page", "type": "boolean", "description": "Return one dataset row per PDF page, PowerPoint slide or Excel sheet (with pageNumber) instead of one row per document. Handy for page-level citations and RAG chunking. Other formats always give one row.", "default": false }, "pageRange": { "title": "Page range", "type": "string", "description": "Optional: only convert these pages / slides / sheets, e.g. \"1-5, 8, 10-\" (\"10-\" = page 10 to the end). Leave empty for all pages." }, "maxPages": { "title": "Max pages per document", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Convert at most this many pages / slides / sheets of each document (after the page range). 0 = no limit. Limits the cost of very long PDFs.", "default": 0 }, "includeTables": { "title": "Include tables", "type": "boolean", "description": "Keep tables from Word, PowerPoint and web pages as Markdown tables (tab-separated in plain text). Spreadsheets and CSV files are always tables. PDF tables come out as text lines (no table reconstruction).", "default": true }, "includeLinks": { "title": "Keep links", "type": "boolean", "description": "Keep hyperlinks as [text](url) in the Markdown of web pages and Word files. Off = cleaner text for LLMs.", "default": false }, "maxRowsPerSheet": { "title": "Max rows per sheet", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Excel and CSV: convert at most this many rows per sheet (huge sheets make huge Markdown).", "default": 1000 }, "maxFileSizeMb": { "title": "Max file size", "minimum": 1, "maximum": 200, "type": "integer", "description": "Files larger than this are skipped (not charged). Checked before and during the download.", "default": 50 }, "maxConcurrency": { "title": "Parallel downloads", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many documents are downloaded at the same time.", "default": 4 }, "requestTimeoutSecs": { "title": "Download timeout", "minimum": 10, "maximum": 600, "type": "integer", "description": "Maximum time to download one document, all retries included.", "default": 90 } } }, "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 } } } } } } } } } }