# Erome Downloader (`solidcode/erome-scraper-video-downloader`) Actor \[💰 $1.7 / 1K] Download videos and images from Erome albums, profiles, or search. Paste album links, profile links, or usernames and get one row per media item, with direct links and optional file downloads. - **URL**: https://apify.com/solidcode/erome-scraper-video-downloader.md - **Developed by:** [SolidCode](https://apify.com/solidcode) (community) - **Categories:** Videos, Social media, Automation - **Stats:** 14 total users, 3 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.70 / 1,000 results 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Erome Downloader Collect videos and images from Erome at scale — one clean row per media item, with the direct file link, thumbnail, uploader, tags, and full album details, plus optional one-click file downloads into your run's storage. Feed it album links, profile links, bare usernames, or a keyword search — all in the same run. Built for content archivists, media researchers, and collection managers who need Erome media in bulk, structured and ready to use, without saving hundreds of files one page at a time. ### Why This Scraper? - **Three ways in, one run** — paste specific album links, crawl an entire user profile, or run a keyword search across Erome, and mix all three in a single job. No separate runs, no stitching results together afterward. - **Videos and images in a single pass** — every album is read once and returns both its videos and its images, each tagged with a `type` of `video` or `image` so you can split them downstream in one filter. - **One row per media item, fully self-describing** — each video or image is its own row carrying the direct media URL, a video poster/thumbnail, file extension, and its 1-based position in the album. - **Every album detail stamped on every row** — album ID, album URL, title, uploader username, tag list, and total media count travel with each media item, so grouping and attribution never need a second lookup. - **Optional real-file archiving** — flip one toggle to save the actual video and image files into your run's storage, and each row gets a ready-to-use download link alongside the original media URL. - **Media-type filter built in** — collect everything, videos only, or images only, applied per album so mixed albums return exactly the subset you asked for. - **Bulk profile crawls with a per-profile album cap** — pull a user's entire catalog and cap it at any number of albums (default 50) so one prolific uploader can't blow past your budget. - **A single hard cap on total items** — set the maximum media items for the whole run (videos plus images across every source) and cost stays predictable to the item. ### Use Cases **Content Archiving & Backup** - Snapshot a creator's full profile before it changes or disappears - Save both the direct media links and the actual files in one pass - Rebuild a personal collection from a list of album links - Keep a rolling backup of specific albums on a schedule **Media Research & Analysis** - Study upload patterns across a set of profiles by album and media count - Build a dataset of media URLs and thumbnails for a keyword or theme - Compare how many videos vs. images an uploader publishes over time - Sample albums matching a search term for trend or catalog analysis **Catalog & Metadata Building** - Turn album links into a structured spreadsheet of every media item - Attach uploader, tags, and album title to each media file for search - Deduplicate and index media by album ID and item position - Feed clean per-item rows into a media asset manager **Automation & Integration** - Pipe new media rows straight into Google Sheets or a database - Trigger downstream workflows whenever a profile publishes new albums - Power an internal media dashboard from the JSON output - Schedule recurring pulls of a watchlist of profiles or search terms ### Getting Started #### Download a Single Album The simplest run — just one album link: ```json { "startUrls": ["https://www.erome.com/a/U3CyGACn"] } ```` #### Crawl a Whole Profile Pull every album from a user by username, videos only, and save the files: ```json { "startUrls": ["someusername"], "mediaType": "video", "downloadFiles": true, "maxAlbumsPerProfile": 25 } ``` #### Keyword Search With Filters Search Erome, keep only images, and cap the whole run: ```json { "searchQuery": "sunset", "mediaType": "image", "maxResults": 500, "maxAlbumsPerProfile": 20 } ``` ### Input Reference #### What to Download | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `startUrls` | string\[] | `["https://www.erome.com/a/U3CyGACn"]` | Album links (like `https://www.erome.com/a/U3CyGACn`), profile links, or plain usernames. Each entry is detected automatically: album links pull that album's media, while profile links and usernames pull every album from that user. Mix all three freely. | | `searchQuery` | string | *(empty)* | Optional keyword search across Erome. Matching albums are collected. Use it on its own or alongside the links above. | #### Filters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `mediaType` | select | `All media (videos and images)` | Which media to include from each album: All media (videos and images), Videos only, or Images only. | #### Output Options | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `downloadFiles` | boolean | `false` | When on, the real video and image files are saved to this run's storage and each row gets a ready-to-use download link. When off, you get the direct media links and full details only — faster and cheaper. | #### Limits | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `maxResults` | integer | `1000` | The most media items (videos plus images) to collect in total, across every album, profile, and search. Each media item is one result. | | `maxAlbumsPerProfile` | integer | `50` | For usernames and profile links: the most albums to pull from a single user. Ignored for direct album links. | ### Output Each row is one media item, with its album's details denormalized onto it. Here's a representative video row with file download turned on: ```json { "type": "video", "mediaUrl": "https://v12.erome.com/1234/U3CyGACn/abc123_720p.mp4", "thumbnailUrl": "https://s7.erome.com/1234/U3CyGACn/abc123.jpg", "filename": "U3CyGACn_1.mp4", "extension": "mp4", "num": 1, "albumId": "U3CyGACn", "albumUrl": "https://www.erome.com/a/U3CyGACn", "albumTitle": "Summer trip highlights", "user": "someusername", "tags": ["summer", "beach", "travel"], "albumMediaCount": 14, "uploadDate": null, "downloadUrl": "https://api.apify.com/v2/key-value-stores/abc/records/U3CyGACn_1.mp4", "kvStoreKey": "U3CyGACn_1.mp4", "status": "ok", "error": null } ``` #### Media Fields | Field | Type | Description | |-------|------|-------------| | `type` | string | `video` or `image` | | `mediaUrl` | string | Direct URL of the media file | | `thumbnailUrl` | string | Poster/preview image for videos; the image itself for images | | `filename` | string | Suggested filename, `_.` | | `extension` | string | File extension (`mp4`, `jpg`, …) | | `num` | number | 1-based position of the item within its album | #### Album Fields (on every row) | Field | Type | Description | |-------|------|-------------| | `albumId` | string | Erome album ID | | `albumUrl` | string | Source album URL | | `albumTitle` | string | Album title | | `user` | string | Uploader username | | `tags` | string\[] | Album tags | | `albumMediaCount` | number | Total media items in the album | | `uploadDate` | string | Album upload date when shown by Erome | #### File & Status Fields | Field | Type | Description | |-------|------|-------------| | `downloadUrl` | string | Direct download link to the saved file — present only when file download is on | | `kvStoreKey` | string | Storage key of the saved file — present only when file download is on | | `status` | string | `ok` when the row is complete, or `failed` when file download was requested but the file couldn't be saved | | `error` | string | Short reason when `status` is `failed` | ### Tips for Best Results - **Start with one album** — run a single album link first to confirm the output shape matches what you need, then scale up to profiles and search. - **A bare username is the fastest profile crawl** — you don't need the full profile URL; just type the username into the links field and every album from that user is expanded automatically. - **Set `maxResults` to bound cost** — it counts individual media items (videos plus images), so a run capped at 500 stops at exactly 500 items no matter how large the albums are. - **Leave file download off unless you need the actual files** — direct media links plus full details cover most workflows and finish faster; turn download on only when you want the files saved in storage. - **Filter by media type at the source** — set Videos only or Images only so mixed albums return just the subset you want, instead of filtering thousands of rows afterward. - **Combine sources in one run** — album links, profile usernames, and a search keyword can all go into the same job; results stream into one dataset with the album details on every row. - **Group by `albumId` downstream** — because every album detail is stamped on each media row, a single group-by on `albumId` reassembles complete albums with no second pass. ### Pricing **From $1.70 per 1,000 results** — a flat pay-per-result rate that undercuts comparable Erome downloaders, with actual file downloads included at no surcharge. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier. | Results | No discount | Bronze | Silver | Gold | |---------|-------------|--------|--------|------| | 100 | $0.20 | $0.19 | $0.18 | $0.17 | | 1,000 | $2.00 | $1.90 | $1.80 | $1.70 | | 10,000 | $20.00 | $19.00 | $18.00 | $17.00 | | 100,000 | $200.00 | $190.00 | $180.00 | $170.00 | A "result" is one collected media item — each video or image is a single result. There are no compute or time-based charges — you pay per result, plus a small fixed per-run start fee. Turning on file download saves the actual files at the same per-result price, with no extra charge. ### Integrations Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via: - **Zapier** / **Make** / **n8n** — Workflow automation - **Google Sheets** — Direct spreadsheet export - **Slack** / **Email** — Notifications on new results - **Webhooks** — Trigger custom APIs on run completion - **Apify API** — Full programmatic access ### Legal & Ethical Use This actor is intended for lawful use such as personal backup, archiving of content you have the right to save, and legitimate research. Erome hosts adult content, so use is limited to adults where such material is legal. You are responsible for complying with all applicable laws, with Erome's Terms of Service, and with the rights of the creators whose media you collect — do not redistribute, misrepresent, or otherwise use collected media in ways that infringe those rights or any person's privacy. Only collect content that is publicly available and that you are permitted to access, and do not use the data for harassment or any unlawful purpose. # Actor input Schema ## `startUrls` (type: `array`): Paste one or more Erome album links (like https://www.erome.com/a/U3CyGACn), user-profile links, or plain usernames. Each entry is detected automatically: album links pull that album's media, while profile links and usernames pull every album from that user. Leave empty if you only want to search. ## `searchQuery` (type: `string`): Optional. Search Erome for a keyword and collect the albums that match. You can use this on its own or alongside the links above. ## `mediaType` (type: `string`): Choose which media to include from each album. ## `downloadFiles` (type: `boolean`): When on, the real video and image files are saved to this run's storage and each row gets a ready-to-use download link. When off (the default), you get the direct media links and full metadata only — which is faster and cheaper. ## `maxResults` (type: `integer`): The most media items (videos plus images) to collect in total, across every album, profile, and search. Each media item is one result. Lower this to keep runs small and predictable. ## `maxAlbumsPerProfile` (type: `integer`): For usernames and profile links: the most albums to pull from a single user. Ignored for direct album links. ## Actor input object example ```json { "startUrls": [ "https://www.erome.com/a/U3CyGACn" ], "mediaType": "all", "downloadFiles": false, "maxResults": 1000, "maxAlbumsPerProfile": 50 } ``` # Actor output Schema ## `overview` (type: `string`): Table of collected media with type, album, direct link, and download link. ## `detail` (type: `string`): Full per-item detail including uploader, tags, album media count, filename, and storage key. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ "https://www.erome.com/a/U3CyGACn" ], "mediaType": "all", "downloadFiles": false, "maxResults": 1000, "maxAlbumsPerProfile": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("solidcode/erome-scraper-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": ["https://www.erome.com/a/U3CyGACn"], "mediaType": "all", "downloadFiles": False, "maxResults": 1000, "maxAlbumsPerProfile": 50, } # Run the Actor and wait for it to finish run = client.actor("solidcode/erome-scraper-video-downloader").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ "https://www.erome.com/a/U3CyGACn" ], "mediaType": "all", "downloadFiles": false, "maxResults": 1000, "maxAlbumsPerProfile": 50 }' | apify call solidcode/erome-scraper-video-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solidcode/erome-scraper-video-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Erome Downloader", "description": "[💰 $1.7 / 1K] Download videos and images from Erome albums, profiles, or search. Paste album links, profile links, or usernames and get one row per media item, with direct links and optional file downloads.", "version": "1.0", "x-build-id": "lnlDN1i25U7ET3oeO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~erome-scraper-video-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-erome-scraper-video-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/solidcode~erome-scraper-video-downloader/runs": { "post": { "operationId": "runs-sync-solidcode-erome-scraper-video-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/solidcode~erome-scraper-video-downloader/run-sync": { "post": { "operationId": "run-sync-solidcode-erome-scraper-video-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": { "startUrls": { "title": "Album links, profiles, or usernames", "type": "array", "description": "Paste one or more Erome album links (like https://www.erome.com/a/U3CyGACn), user-profile links, or plain usernames. Each entry is detected automatically: album links pull that album's media, while profile links and usernames pull every album from that user. Leave empty if you only want to search.", "items": { "type": "string" } }, "searchQuery": { "title": "Search Erome", "type": "string", "description": "Optional. Search Erome for a keyword and collect the albums that match. You can use this on its own or alongside the links above." }, "mediaType": { "title": "Media type", "enum": [ "all", "video", "image" ], "type": "string", "description": "Choose which media to include from each album.", "default": "all" }, "downloadFiles": { "title": "Download the actual files", "type": "boolean", "description": "When on, the real video and image files are saved to this run's storage and each row gets a ready-to-use download link. When off (the default), you get the direct media links and full metadata only — which is faster and cheaper.", "default": false }, "maxResults": { "title": "Maximum media items", "minimum": 1, "type": "integer", "description": "The most media items (videos plus images) to collect in total, across every album, profile, and search. Each media item is one result. Lower this to keep runs small and predictable.", "default": 1000 }, "maxAlbumsPerProfile": { "title": "Maximum albums per profile", "minimum": 1, "type": "integer", "description": "For usernames and profile links: the most albums to pull from a single user. Ignored for direct album links.", "default": 50 } } }, "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 } } }, "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 } } } } } } } } } } ```