Bulk file and image downloader data API: fields, sample output and cost per 1,000 rows

Download files in bulk from direct links, or every image, video, audio file, PDF, document or archive on a list of web pages.

This is the reference for the Actor v0iddo/bulk-file-downloader: what is in every output row, what the input takes, and what a run costs. Values below come from a real run of the Actor.

At a glance

Actor	v0iddo/bulk-file-downloader
Store page	Bulk file and image downloader
Output	one row per result, as JSON, CSV, Excel or HTML
Fields per row	17 (11 text, 4 number, 2 URL)
Cap on results	maxItems in the input
Price	$2.00 per 1,000 results

Output fields

Each result is one row with these fields (fields that name people are left out):

Field	Type	Meaning	Sample value
fileUrl	URL	File	https://api.apify.com/v2/key-value-stores/GKrosZlTQ8ZrHctTs/records...
fileName	text	Name	TrinidadandTobagohummingbirdscomposite.jpg
fileType	text	Type	image
fileBytes	number	Bytes	292246
imageWidth	number	Width	1280
imageHeight	number	Height	1280
altText	text	Alt text
url	URL	Source link	https://thumb.wikimedia.org/wikipedia/commons/thumb/7/7c/Trinidad_a...
error	text	Error
kind	text		file
pageUrl	text		https://en.wikipedia.org/wiki/Hummingbird
finalUrl	text		https://thumb.wikimedia.org/wikipedia/commons/thumb/7/7c/Trinidad_a...
foundIn	text		og:image
contentType	text		image/jpeg
sha256	text		82cafb5947635e2a5d5244de379932a7697c3aeb0e66bec7ea9e5fde9f78d303
chargeUnits	number		1
downloadedAt	text		2026-10-26T07:22:17Z

One record

{
  "kind": "file",
  "url": "https://thumb.wikimedia.org/wikipedia/commons/thumb/7/7c/Trinidad_and_Tobago_hummingbirds_composite.jpg/1280px-Trinidad_and_Tobago_hummin...",
  "pageUrl": "https://en.wikipedia.org/wiki/Hummingbird",
  "finalUrl": "https://thumb.wikimedia.org/wikipedia/commons/thumb/7/7c/Trinidad_and_Tobago_hummingbirds_composite.jpg/1280px-Trinidad_and_Tobago_hummin...",
  "foundIn": "og:image",
  "fileName": "Trinidad_and_Tobago_hummingbirds_composite.jpg",
  "fileType": "image",
  "contentType": "image/jpeg",
  "fileBytes": 292246,
  "sha256": "82cafb5947635e2a5d5244de379932a7697c3aeb0e66bec7ea9e5fde9f78d303",
  "imageWidth": 1280,
  "imageHeight": 1280,
  "fileUrl": "https://api.apify.com/v2/key-value-stores/GKrosZlTQ8ZrHctTs/records/000001-Trinidad_and_Tobago_hummingbirds_composite.jpg?signature=z1kCA...",
  "chargeUnits": 1,
  "downloadedAt": "2026-10-26T07:22:17Z"
}

Input parameters

Parameter	Type	Required	Default	What it does
fileUrls	array	no		Direct links to files of any type (images, video, audio, PDF, documents, archives).
pageUrls	array	no	["https://en.wikipedia.org/wiki/Hummingbird"]	Web pages to download files from: the images it shows (the largest size it offers), its video and audio, and the files it links to, filtered by File types.
fileTypes	array	no	["image"]	Which files to take from Pages.
sameSiteOnly	boolean	no	false	Take only files on the host of the page or its subdomains, leaving out files on other hosts (many sites keep their images on a separate CDN host, so this can drop them).
maxFilesPerPage	integer	no	200	Caps the files taken from one page, in the order they appear on it.
minImageKB	integer	no	5	Images found on pages that are smaller than this are left out (icons, spacers, tracking pixels) and not charged; 0 keeps every image.
maxFileMB	integer	no	100	Larger files come back as a row with the reason, at no charge.
maxItems	integer	no	1000	The run stops after this many result rows.

Ready-made examples

Saved inputs on Apify: run one as it is, or copy it and change the values.

• Download every PDF linked from a web page: IRS forms
• Download images from a list of image links
• Download all images from a web page: hummingbird article

Cost per 1,000 rows

$2.00 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $1.40 per 1,000.

Results	Cost at the listed price	Cost at the lowest plan price
100	$0.20	$0.14
1,000	$2.00	$1.40
10,000	$20.00	$14.00
100,000	$200.00	$140.00

The figures are the listed price times the number of results. The maxItems limit and the maximum cost setting in the run options both stop a run before it spends more than you planned.

Get the rows as CSV over HTTP

One request starts a run, waits for it and returns the dataset. The format parameter picks the file type and fields picks the columns. Replace the token with the one from Apify Console, Settings, Integrations.

curl -X POST "https://api.apify.com/v2/acts/v0iddo~bulk-file-downloader/run-sync-get-dataset-items?format=csv&fields=fileUrl,fileName,fileType" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pageUrls": ["https://en.wikipedia.org/wiki/Hummingbird"], "fileTypes": ["image"], "maxFilesPerPage": 20, "maxItems": 20}'

Good to know

• Images on pages come in the largest size the page offers in srcset, and lazy loading attributes (data-src and the like) are read, so the real image is taken instead of a placeholder.
• The same file under two links is stored once: the second row has duplicateOf and costs nothing. A link that appears on several pages is downloaded once.

Links

• Actor on the Apify Store: Bulk file and image downloader
• Guide with the Python and JavaScript code: https://voidd0.github.io/bulk-file-downloader/