{ "openapi": "3.0.1", "info": { "title": "Bulk File Downloader — PDFs, Docs & Any File to ZIP", "description": "Download any files in bulk — from a list of file links or by finding every PDF, document, spreadsheet or archive linked on web pages and whole sites. Filter by type and size, skip duplicates, keep original names, and get one ZIP plus a link per file.", "version": "1.0", "x-build-id": "gd2yWxwysgl23Dgub" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hipersoft~bulk-file-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hipersoft-bulk-file-downloader", "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/hipersoft~bulk-file-downloader/runs": { "post": { "operationId": "runs-sync-hipersoft-bulk-file-downloader", "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/hipersoft~bulk-file-downloader/run-sync": { "post": { "operationId": "run-sync-hipersoft-bulk-file-downloader", "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": { "fileUrls": { "title": "File URLs", "type": "array", "description": "Direct links to files (PDFs, documents, spreadsheets, archives, audio, video, images…). Each one is downloaded and saved.", "items": { "type": "string" } }, "pageUrls": { "title": "Page URLs (find files on pages)", "type": "array", "description": "Web pages to scan for links to files. Every linked file of the chosen types is downloaded.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "crawlSameSite": { "title": "Also scan linked pages on the same site", "type": "boolean", "description": "Follow links to other pages on the same website and collect their files too (up to “Max pages”).", "default": false }, "maxPages": { "title": "Max pages", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of pages to scan.", "default": 10 }, "fileTypes": { "title": "File types", "type": "array", "description": "Only keep these file types, e.g. pdf, docx, xlsx, csv, zip, mp3, mp4. Empty = all types for direct URLs, and common documents (pdf, doc/docx, xls/xlsx, ppt/pptx, csv, txt, rtf, odt, ods, epub, zip, json, xml) when scanning pages.", "default": [], "items": { "type": "string" } }, "maxFiles": { "title": "Max files", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after saving this many files.", "default": 100 }, "maxFileMb": { "title": "Max size per file (MB)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Skip files larger than this.", "default": 100 }, "maxTotalMb": { "title": "Max total download (MB)", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop saving once this much has been downloaded in total.", "default": 2000 }, "skipDuplicates": { "title": "Skip duplicate files", "type": "boolean", "description": "Files with identical content are saved once, even under different URLs.", "default": true }, "storeFiles": { "title": "Store each file", "type": "boolean", "description": "Save every file in the run's storage with a direct download link.", "default": true }, "createZip": { "title": "Create one ZIP of all files", "type": "boolean", "description": "Bundle all saved files into a single files.zip download (up to 400 MB).", "default": true }, "fileNaming": { "title": "File names", "enum": [ "original", "numbered", "hash" ], "type": "string", "description": "How saved files are named.", "default": "original" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional proxy for loading pages. Files themselves are downloaded directly.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }