# 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](https://apify.com/v0iddo/bulk-file-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

```json
{
  "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](https://apify.com/v0iddo/bulk-file-downloader/examples/download-all-pdfs-from-a-page)
- [Download images from a list of image links](https://apify.com/v0iddo/bulk-file-downloader/examples/download-images-from-urls)
- [Download all images from a web page: hummingbird article](https://apify.com/v0iddo/bulk-file-downloader/examples/download-all-images-from-a-web-page)

## 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.

```bash
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](https://apify.com/v0iddo/bulk-file-downloader)
- Guide with the Python and JavaScript code: [https://voidd0.github.io/bulk-file-downloader/](https://voidd0.github.io/bulk-file-downloader/)