# Erome Video Downloader (`datawatcher/erome-video-downloader`) Actor

Downloads the videos (.mp4) and images of erome.com albums, searches and creator profiles into your Apify storage, named albumId_mediaId.ext. Optional ZIP of all files and optional full details (views, likes, duration).

- **URL**: https://apify.com/datawatcher/erome-video-downloader.md
- **Developed by:** [DataWatcher](https://apify.com/datawatcher) (community)
- **Categories:** Videos
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $6.80 / 1,000 video file saveds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Erome Video Downloader

**Download Erome videos and images in bulk**: scrape erome.com albums by keyword search, creator profile or album URL and get the data of each media file with **each file** saved in your run's Key-Value Store. Files are named **`{albumId}_{mediaId}.{ext}`** (for example `AlbumId1_MediaId1.mp4`), so the files of one album sit together. Every row has the link to the saved file. Get the rows as JSON, CSV or Excel, or through the API.

- Saved file: `storedFile` (key, public link, size in bytes, type, status).
- File names: `{albumId}_{mediaId}.mp4` for videos and `{albumId}_{mediaId}.<ext>` for images, no folders, the same names inside `videos.zip`.
- The actor sends the header `Referer: https://www.erome.com/` for you, so the files are saved without a 403.
- Short rows by default (files first). Set `extractDetails` to `true` for the full row.
- Optional `videos.zip` with all saved files of the run (`createZip`).

Need only links and data, without files? Use the [Erome Video Scraper](https://apify.com/datawatcher/erome-scraper).

### ⭐ Why this one

> **1️⃣ One schema across video sites.**
> All our video actors share one output schema and one input schema. Build your pipeline once: our other video actors ([Erome Video Scraper](https://apify.com/datawatcher/erome-scraper), [Redgifs Video Scraper](https://apify.com/datawatcher/redgifs-scraper), [XFree Video Scraper](https://apify.com/datawatcher/xfree-scraper), [RedGIFs Video Downloader](https://apify.com/datawatcher/redgifs-video-downloader), [XFree Video Downloader](https://apify.com/datawatcher/xfree-video-downloader)) take the same input and return the same fields, so adding a site means changing the actor name, not your code.

- **Real files, one price.** $0.008 per saved file ($8.00 per 1,000), no start fee.
- **The header is handled.** erome.com files need `Referer: https://www.erome.com/`; the actor sends it, so you get the file, not an error.
- **Files named for you.** Every file is `{albumId}_{mediaId}.{ext}`, so the media of one album sort together.
- **One ZIP of the run.** Turn on `createZip` and get `videos.zip` with all files under the same names.
- **Videos and images.** A video is saved as the `.mp4` in 720p, an image as the full-size picture; `mediaType` tells you which.
- **Free when nothing is saved.** Skipped and failed files, and duplicate files, cost nothing; their rows are still returned.
- **Honest runs.** A run summary (`OUTPUT`) and a health status (`RUN_HEALTH`) tell you what was saved and why a run is not `ok`.

### 🎯 Use cases

- Archive an Erome album or a creator's profile as named files, in one ZIP.
- Build a local library of videos from a keyword search, grouped by album.
- Feed an editing or content-review pipeline with real `.mp4` files through the Apify API.
- Run the same pipeline over several video sites, since they share one schema.

### 🔎 What it extracts

One row per unique media file (video or image) of an album, with its file saved. The page types it reads:

| Page type | Example URL | Input to use |
|---|---|---|
| Search | `https://www.erome.com/search?q=example+words` | `searchQueries` or `startUrls` |
| Profile | `https://www.erome.com/CreatorName` | `usernames` or `startUrls` |
| Album page | `https://www.erome.com/a/AlbumId1` | `videoUrls` or `startUrls` |

- Search filter: `all` (default) or `post`. A search finds albums by title.
- A profile gives the posts and reposts of the creator.
- The site has one video quality (720p), so every video is saved in it.
- The site has no tags and no post date for videos, so `tags` is `[]` and `dates.posted` is `null` for them.

### 🚀 How to scrape Erome videos and save the files

1. Open the actor on Apify and click **Try for free**.
2. Fill in a search, creators or album URLs, or paste erome.com URLs into `startUrls` or `videoUrls`.
3. Click **Start**.
4. Open the Output tab: **Files** links to your files in the Key-Value Store, **Saved files** lists the rows. Download the rows as JSON, CSV or Excel, or fetch them with the Apify API.

Example inputs:

```json
{ "videoUrls": ["https://www.erome.com/a/AlbumId1"] }
```

```json
{ "usernames": ["CreatorName"], "maxResults": 20, "createZip": true }
```

```json
{ "searchQueries": [{ "query": "example words", "filter": "all" }], "maxResults": 10, "extractDetails": true }
```

### 🔌 Run it your way

- **Schedule it** with Apify schedules.
- **Call it from the Apify API** and its clients (Python, JavaScript).
- **Connect it** to Make, n8n, Zapier, webhooks or Google Sheets.

### 💾 Where the files are

- On the Output tab, the **Files** link opens the run's default **Key-Value Store**. Each file is there as `{albumId}_{mediaId}.{ext}`. `storedFile.url` is its public link.
- With `createZip` set to `true`, the store also holds `videos.zip` (key `videos.zip`) with all saved files, under the same names. The `OUTPUT` record has `zipUrl` (the signed link to the ZIP) and `fileCount` (files saved).
- Links are signed. A store that is not named is deleted by Apify after about 7 days. Download the files you need before that, or copy them to a named store.
- The storage is billed by Apify to your account, like any run.

`storedFile.status` says what happened to the file:

| Status | Meaning | Charged |
|---|---|---|
| `saved` | The file is in the store. | Yes, `video-file-saved`. |
| `skipped` | Not downloaded: the file is over `maxFileSizeMb`, the run reached `maxTotalDownloadMb`, the row has no file link, or the free plan limit of 50 files per run is reached. `storedFile.error` says which. | No |
| `failed` | The download failed (for example HTTP 404). One retry is made first. `storedFile.error` says why. | No |

The row of a skipped or failed file is still returned, free.

### ⚖️ Rights

Saved videos and images belong to their creators. You are responsible for having the right to save, keep and use them, and for following the law and erome.com terms.

### ⚙️ Input

| Input | Type | Default | Range | Meaning |
|---|---|---|---|---|
| `startUrls` | list of URLs | none | erome.com URLs | Search, profile or album URLs. The kind is found from the URL. |
| `searchQueries` | list | none | – | Items `{"query": "...", "filter": "all" \| "post"}`. A plain text line means `{"query": text, "filter": "all"}`. |
| `usernames` | list of text | none | – | Creator names, with or without `@`, or profile URLs. Every album of each creator. |
| `videoUrls` | list of URLs | none | – | Album page URLs. Every media file of the album. |
| `extractDetails` | yes/no | `false` | – | `false`: a short row, files first. `true`: the full row (views, likes, links) plus `storedFile`. |
| `videoQuality` | text | `best` | `best` | The site has one video quality (720p), so `best` is the only value. |
| `maxFileSizeMb` | integer | `250` | 1 to 2,000 | A bigger file is skipped. |
| `maxTotalDownloadMb` | integer | `1024` | 1 to 20,000 | Files stop being saved when the saved files of the run together reach this size. |
| `createZip` | yes/no | `false` | – | Also save `videos.zip`. |
| `maxResults` | integer | `100` | 1 to 1,000 | Maximum files returned over all inputs. The free Apify plan returns up to 1,000 results per run. |
| `maxRequests` | integer | `200` | 1 to 1,000 | Maximum requests of the run (list pages and albums). The file downloads are not counted. |
| `maxPagesPerSource` | integer | `100` | 1 to 100 | Maximum list pages for one search or profile. |
| `maxScrollsPerPage` | integer | `100` | 1 to 100 | Not used on this site (pages are numbered). |
| `maxRequestRetries` | integer | `2` | 0 to 5 | Retries after a network error or a server error. |
| `requestTimeoutSecs` | integer | `30` | 5 to 120 | Time limit of one request, in seconds. |

Use at least one of `startUrls`, `searchQueries`, `usernames` or `videoUrls`. The inputs `tags` and `tagSort` are shared by all our video actors and are not used here, because erome.com has no tags.

### 📦 Output: Erome video data

The short row (default) has `id`, `url`, `mediaType` (`video` or `image`), `title`, `creator`, `durationSeconds`, `width`, `height`, `imageUrl` (the picture of an image, empty for videos), `storedFile` and `dates`. With `extractDetails` set to `true`, it also has `views`, `likes`, `thumbnailUrl`, `posterUrl`, `videoFileUrl` and the other full-row fields. A missing text, number or object is `null`. A missing list is `[]`.

| Field | Type | Meaning |
|---|---|---|
| `storedFile.key` | text or null | The store key of the saved file, e.g. `AlbumId1_MediaId1.mp4`. |
| `storedFile.url` | text or null | The public link to the saved file. |
| `storedFile.sizeBytes` | integer or null | The saved file's size in bytes. |
| `storedFile.mimeType` | text or null | The file's content type, e.g. `video/mp4` or `image/jpeg`. |
| `storedFile.quality` | text or null | `best`: the copy that was saved. |
| `storedFile.status` | text | `saved`, `skipped` or `failed`. |
| `storedFile.error` | text or null | Why the file was skipped or failed; `null` when saved. |

#### Example: a row

An example row (`videoUrls` input, short row).

```json
{
  "recordType": "video",
  "source": "erome",
  "id": "MediaId1",
  "url": "https://www.erome.com/a/AlbumId1",
  "mediaType": "video",
  "title": "Example album",
  "creator": { "username": "CreatorName", "displayName": "CreatorName", "profileUrl": "https://www.erome.com/CreatorName" },
  "durationSeconds": 9,
  "storedFile": {
    "key": "AlbumId1_MediaId1.mp4",
    "url": "https://api.apify.com/v2/key-value-stores/EXAMPLEID/records/AlbumId1_MediaId1.mp4",
    "sizeBytes": 1706343,
    "mimeType": "video/mp4",
    "quality": "best",
    "status": "saved"
  },
  "dates": { "scraped": "2025-01-02T12:00:00Z" }
}
```

### 📊 Run stats

Each run saves two records in the key-value store. `OUTPUT` has the run counters and these for the files:

| Key | Meaning |
|---|---|
| `filesSaved`, `filesSkipped`, `filesFailed` | Files by status. |
| `fileCount` | Files saved. |
| `bytesSaved` | Total size of the saved files. |
| `zipUrl` | The signed link to `videos.zip`; `null` without a ZIP. |
| `stopReason` | The cap that ended the run: `maxResults`, `maxRequests`, `maxPagesPerSource` or `chargeLimit`; else `null`. |

`RUN_HEALTH`: `{"status": "ok" | "degraded" | "failed", "reason": ...}`. `reason` says why a run is not `ok`, for example that some files failed.

### 💰 Pricing

Pay per event, one event: **$0.008** per saved file (**$8.00** per 1,000 files). There is no start fee. The row alone is free, and so are skipped and failed files and duplicate files.

| Event | Price | When it is charged |
|---|---|---|
| `video-file-saved` | $0.008 ($8.00 per 1,000) | Each video or image file saved in your store. |

- Free plan: up to 1,000 results per run with full details, and up to 50 files saved per run. Paying plans have no cap per run.

### ❓ FAQ

#### Where is the video data and where are the downloaded files?

Open the **Files** link on the Output tab of the run. Each file is there as `{albumId}_{mediaId}.{ext}`, and `storedFile.url` in every row links to it.

#### How do I download all videos of one Erome creator?

Put the creator name in `usernames`, set `maxResults`, and turn on `createZip` to get one `videos.zip`.

#### How do I export Erome videos to Excel or CSV?

Run the actor, open the Output tab and pick Excel or CSV in the export options. JSON, XML and HTML are there too, and the Apify API returns the same data.

#### How much does it cost to bulk download Erome videos?

$0.008 per saved file, nothing for the row alone, skipped or failed files. The free Apify plan saves up to 50 files per run.

#### Can I use it with other video sites?

Yes. Our video actors share one output schema, so the same pipeline reads them all. See the list below.

### Data notice

This actor returns only what the site shows publicly at run time. We don't store or keep that data and are not its controller — you decide how you use it.

### 🔗 Other video scrapers (same schema)

#### Erome (this site)

- [Erome Video Scraper](https://apify.com/datawatcher/erome-scraper): links and data

#### RedGIFs

- [Redgifs Video Scraper](https://apify.com/datawatcher/redgifs-scraper): links and data
- [RedGIFs Video Downloader](https://apify.com/datawatcher/redgifs-video-downloader): saves the video files (.mp4)

#### XFree

- [XFree Video Scraper](https://apify.com/datawatcher/xfree-scraper): links and data
- [XFree Video Downloader](https://apify.com/datawatcher/xfree-video-downloader): saves the video files (.mp4)

### 💬 Feedback and custom work

Need another portal, a field or a custom feed? Open an issue on the Issues tab.

# Changelog

This Actor's version history is a separate document: https://apify.com/datawatcher/erome-video-downloader/changelog.md

# Actor input Schema

## `startUrls` (type: `array`):

Site URLs of any supported kind: search, account profile, tag or video page. The kind is found from the URL.

## `searchQueries` (type: `array`):

Searches, each {"query": "...", "filter": "all" | "post" | "tag"} (filter optional, default "all"). A plain text line is read as {"query": text, "filter": "all"}.

## `usernames` (type: `array`):

Account handles, with or without "@", or profile URLs. Every video of each account.

## `tags` (type: `array`):

Tag names exactly as the site writes them (case and prefixes kept, e.g. pl-Amatorzy), or tag page URLs.

## `tagSort` (type: `string`):

The order of tag pages. Empty - the site's default order.

## `videoUrls` (type: `array`):

Video page URLs. Each is read directly; one row per video.

## `maxResults` (type: `integer`):

Maximum number of videos returned, in total. Shared fairly over the inputs (each search, profile, tag or video URL gets its part; what one cannot fill goes to the others). Free plan Apify users get at most 1000 videos per run, whatever is set here (paying users have no cap).

## `maxRequests` (type: `integer`):

Maximum number of page requests the run makes, in total (listing pages and load-more steps; a direct video URL is one request).

## `maxPagesPerSource` (type: `integer`):

Maximum number of listing pages read for one search, profile or tag.

## `maxScrollsPerPage` (type: `integer`):

Maximum number of "Show more" / load-more steps on one listing page.

## `maxRequestRetries` (type: `integer`):

Retries of a request that failed on a network error or a server error. A block (403, 429, a challenge page) is never retried.

## `requestTimeoutSecs` (type: `integer`):

Time limit of one page request.

## `extractDetails` (type: `boolean`):

false (default): a short row, files first (id, url, title, creator, duration, size, `storedFile`, dates). true: the full row of the links actor (views, likes, tags, tagged accounts, links ...) plus `storedFile`.

## `videoQuality` (type: `string`):

Which file to save. "best" is the full-quality .mp4 (`videoFileUrl`), "preview" the smaller copy (`previewVideoUrl`).

## `maxFileSizeMb` (type: `integer`):

A video bigger than this is not saved (its `storedFile.status` is "skipped"); its row is still written.

## `maxTotalDownloadMb` (type: `integer`):

Stops saving files when the files of this run together reach this size (the rest are "skipped"); rows are still written.

## `createZip` (type: `boolean`):

Also put all saved files into one `videos.zip` in the Key-Value Store (needs disk space for the whole archive).

## Actor input object example

```json
{
  "maxResults": 100,
  "maxRequests": 200,
  "maxPagesPerSource": 100,
  "maxScrollsPerPage": 100,
  "maxRequestRetries": 2,
  "requestTimeoutSecs": 30,
  "extractDetails": false,
  "videoQuality": "best",
  "maxFileSizeMb": 250,
  "maxTotalDownloadMb": 1024,
  "createZip": false
}
```

# Actor output Schema

## `results` (type: `string`):

One row per item.

## `runSummary` (type: `string`):

OUTPUT: status, sources, requests used, early stop and its reason, source errors, charged events.

## `runHealth` (type: `string`):

{status, reason}: ok, degraded, or failed.

## `files` (type: `string`):

The saved video files (.mp4) in the run's Key-Value Store. With "Create ZIP", `videos.zip` is among them and its public link is `zipUrl` in the OUTPUT record.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("datawatcher/erome-video-downloader").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("datawatcher/erome-video-downloader").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call datawatcher/erome-video-downloader --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,datawatcher/erome-video-downloader"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/UdaHn7qTN2ISSteVo/builds/TyL73eTr7qEPQ5W0f/openapi.json