{ "openapi": "3.0.1", "info": { "title": "PDF & Image to Text: OCR in Arabic, Urdu, Sinhala + 18 more", "description": "Extract clean text or Markdown from PDFs and images. Reads the text layer when there is one and runs OCR only on scanned pages, so you pay OCR prices only where OCR is needed. 21 OCR languages including Arabic, Urdu, Persian, Sinhala, Tamil, Hindi and Bengali.", "version": "0.0", "x-build-id": "dvAYXkJ6J95lbjOPD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ammartheawesome~pdf-image-text-ocr/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ammartheawesome-pdf-image-text-ocr", "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/ammartheawesome~pdf-image-text-ocr/runs": { "post": { "operationId": "runs-sync-ammartheawesome-pdf-image-text-ocr", "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/ammartheawesome~pdf-image-text-ocr/run-sync": { "post": { "operationId": "run-sync-ammartheawesome-pdf-image-text-ocr", "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", "required": [ "sources" ], "properties": { "sources": { "title": "Files", "type": "array", "description": "Direct links to PDF or image files (PNG, JPEG, TIFF, GIF, BMP, WebP). Each link must download the file itself, not a page that shows it.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "ocrMode": { "title": "OCR mode", "enum": [ "auto", "always", "never" ], "type": "string", "description": "auto: OCR only pages without a usable text layer (recommended, cheapest). always: OCR every page, e.g. when a PDF's text layer is garbled. never: text layer only, no OCR.", "default": "auto" }, "languages": { "title": "OCR languages", "type": "array", "description": "Languages in the documents, as Tesseract codes. Add every language that appears (e.g. eng and ara for an English/Arabic document). Supported: eng, ara, urd, fas, sin, tam, hin, ben, msa, ind, tur, fra, deu, spa, por, ita, nld, rus, chi_sim, jpn, kor.", "default": [ "eng" ], "items": { "type": "string" } }, "outputFormat": { "title": "Output format", "enum": [ "text", "markdown" ], "type": "string", "description": "text: plain text. markdown: a title and one heading per page, ready for LLM or RAG pipelines.", "default": "text" }, "includePages": { "title": "Include per-page text", "type": "boolean", "description": "Also return each page's text and how it was read (text layer, OCR or empty).", "default": true }, "maxPagesPerFile": { "title": "Max pages per file", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Pages after this are skipped (and not charged). The output marks the file as truncated.", "default": 200 }, "maxFileSizeMb": { "title": "Max file size (MB)", "minimum": 1, "maximum": 200, "type": "integer", "description": "Larger files are skipped with an error.", "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 } } } } } } } } } }