{ "openapi": "3.0.1", "info": { "title": "Bulk Article Extractor: Clean Text & Markdown for LLMs", "description": "Turn article URLs into clean Markdown with author, date and language, split into RAG chunks. $0.70 per 1,000, failed pages are free.", "version": "0.1", "x-build-id": "ML36x3U4zBeY0kRyJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/isnard~article-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-isnard-article-extractor", "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/isnard~article-extractor/runs": { "post": { "operationId": "runs-sync-isnard-article-extractor", "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/isnard~article-extractor/run-sync": { "post": { "operationId": "run-sync-isnard-article-extractor", "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": [ "urls" ], "properties": { "urls": { "title": "Article URLs", "type": "array", "description": "Pages to extract, one per line. Only these URLs are fetched, links on them are not followed. A URL without scheme gets https://. Duplicates are fetched once.", "items": { "type": "string" } }, "outputFormat": { "title": "Output format", "enum": [ "text", "markdown", "both" ], "type": "string", "description": "Plain text, Markdown (headings, lists, tables, bold and italics kept) or both.", "default": "both" }, "includeLinks": { "title": "Keep links", "type": "boolean", "description": "Keep hyperlinks inside the article as Markdown links. Affects the Markdown output.", "default": false }, "includeImages": { "title": "Keep images", "type": "boolean", "description": "Keep images inside the article as Markdown images. Affects the Markdown output.", "default": false }, "chunking": { "title": "Split into chunks for RAG", "type": "boolean", "description": "Also return the content split into chunks, at paragraph and sentence boundaries where possible. Chunks are made from the Markdown when the output format is Markdown, otherwise from the plain text.", "default": false }, "chunkSize": { "title": "Chunk size (approximate tokens)", "minimum": 50, "maximum": 8000, "type": "integer", "description": "Maximum chunk size in approximate tokens, counted as 4 characters per token. Real token counts depend on the model and the language.", "default": 500 }, "chunkOverlap": { "title": "Chunk overlap (approximate tokens)", "minimum": 0, "maximum": 2000, "type": "integer", "description": "How much of the end of each chunk is repeated at the start of the next one.", "default": 50 }, "detectLanguage": { "title": "Detect language", "type": "boolean", "description": "Detect the language of the extracted text (ISO 639-1 code in detectedLanguage). The language the page declares is always returned in language.", "default": true }, "respectRobots": { "title": "Respect robots.txt", "type": "boolean", "description": "Skip URLs that the robots.txt of the site disallows for the BulkArticleExtractor user-agent (or for * when it is not named). Skipped URLs are reported and not charged.", "default": true }, "timeoutSecs": { "title": "Timeout per request (seconds)", "minimum": 2, "maximum": 120, "type": "integer", "description": "Maximum time for each request.", "default": 20 } } }, "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 } } } } } } } } } }