# Erome Bulk Video Downloader (`serpxxx/erome-bulk-video-downloader`) Actor Extract direct video URLs, metadata, thumbnails, and format details from Erome links. - **URL**: https://apify.com/serpxxx/erome-bulk-video-downloader.md - **Developed by:** [SERP XXX](https://apify.com/serpxxx) (community) - **Categories:** Videos, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $10.00 / 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. 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 Bulk Video Downloader Extract direct video URLs, metadata, thumbnails, and available formats from Erome video pages at scale. 👉 Get it Here: https://serp.ly/erome-bulk-video-downloader ### What this Erome downloader does Erome Bulk Video Downloader turns a list of Erome video URLs into structured results you can use in automations, research workflows, content archives, QA checks, and internal media tools. Instead of clicking through pages one at a time or relying on a browser extension, submit URLs to an Apify Actor run and receive clean dataset rows with the source page, canonical URL, title, thumbnail, available media formats, selected format, and a fresh direct video URL when extraction succeeds. The default mode is designed to be fast and cost-efficient: it extracts fresh media URLs and metadata without downloading large files. If you need Apify-hosted file output, enable `downloadFiles=true` to store the selected video in the run key-value store. ### Key features - Bulk input: process one URL or a list of Erome video URLs in a single run. - Direct media URL extraction: returns the selected playable video URL when available. - Metadata output: captures title, description when available, duration, thumbnail, canonical URL, and source URL. - Format discovery: returns available MP4, HLS, and other playable formats when the source exposes them. - Quality selection: use `preferredQuality` to request best, HD, SD, or another supported quality label. - Optional file storage: set `downloadFiles=true` only when you want the selected video saved to Apify key-value storage. - Automation-ready output: results are written to the default dataset as structured JSON rows. - Proxy support: enable `useApifyProxy` when the run needs Apify cloud proxy routing. ### Common use cases - Build a private archive workflow for a list of Erome URLs. - Collect video metadata and thumbnails for cataloging or QA. - Resolve fresh direct media URLs for downstream processing. - Monitor whether saved Erome URLs still expose playable media. - Power internal tools that need structured video extraction instead of manual browser work. - Export results as JSON, CSV, Excel, XML, or RSS for other systems. ### Input Provide one or more video URLs through the `urls` array or paste them into `urlText` with one URL per line. ```json { "urls": [ "https://www.example.com/video/sample" ], "maxItems": 2, "preferredQuality": "best", "downloadFiles": false, "createZip": false, "useApifyProxy": false } ```` Important input options: - `urls`: array of Erome video URLs to process. - `urlText`: newline-separated URLs, useful for copy/paste batches. - `maxItems`: maximum number of inputs to process in this run. - `preferredQuality`: choose the best available format or a supported quality label. - `downloadFiles`: keep this `false` for metadata/direct-URL extraction; set to `true` only when you need files stored in Apify. - `createZip`: optional ZIP convenience flag when file storage is supported for the selected run. - `useApifyProxy`: route extraction through Apify Proxy when needed. ### Output Each processed URL produces a dataset row similar to: ```json { "inputUrl": "https://www.example.com/video/sample", "sourceUrl": "https://www.example.com/video/sample", "canonicalUrl": "https://www.example.com/video/sample", "id": "sample-id", "title": "Example video title", "description": null, "duration": "00:03:21", "width": 1280, "height": 720, "tags": [], "thumbnailUrl": "https://cdn.example.com/thumb.jpg", "availableFormats": [], "selectedFormat": { "quality": "best", "type": "video/mp4" }, "directVideoUrl": "https://cdn.example.com/video.mp4", "status": "ok", "errorMessage": null } ``` When `downloadFiles=true`, successful rows may also include: - `storedFileKey` - `storedFileUrl` - `fileSizeBytes` - `zipFileKey` - `zipFileUrl` - `zipFileSizeBytes` ### How to use 1. Open the actor input tab. 2. Paste one or more Erome video URLs. 3. Leave `downloadFiles=false` for the fastest API-style run. 4. Start the actor. 5. Export results from the dataset as JSON, CSV, Excel, XML, or RSS. 6. Use `directVideoUrl`, `thumbnailUrl`, and metadata fields in your downstream workflow. ### Browser extension alternative If you only need a simple browser-based downloader for occasional manual saves, use the SERP browser extension flow instead: https://serp.ly/erome-bulk-video-downloader This Apify Actor is better for bulk jobs, repeatable workflows, scheduled runs, integrations, and structured output. ### Notes and limitations - Direct media URLs can expire. Run the actor when you need fresh URLs. - Some videos may be unavailable, removed, private, geo-restricted, or blocked by the source site. - Large file downloads can increase run time, bandwidth, and storage usage; keep `downloadFiles=false` unless storage is required. - Respect the source site's terms and applicable laws. Only process content you have the right to access and use. ### FAQ #### Can I download multiple Erome videos at once? Yes. Add multiple URLs to the `urls` array or paste one URL per line into `urlText`. #### Does the actor download files by default? No. Default runs return fresh direct media URLs and metadata. Set `downloadFiles=true` only when you need the selected video stored in Apify key-value storage. #### Can I use the results through the Apify API? Yes. Run the actor through the Apify API and read structured results from the default dataset. #### Why did a URL fail? The source page may be unavailable, private, geo-restricted, protected, removed, or temporarily returning a format that cannot be resolved. Failed rows include `status="error"` and an `errorMessage` when available. # Actor input Schema ## `urls` (type: `array`): Erome video URLs, album URLs, or IDs to process. ## `urlText` (type: `string`): Optional fallback: one URL or ID per line. ## `maxItems` (type: `integer`): Maximum result rows to return. ## `preferredQuality` (type: `string`): Quality preference when multiple formats are available. ## `downloadFiles` (type: `boolean`): When enabled, downloads the selected media file and returns storedFileUrl. Default is false to keep runs cheap. ## `createZip` (type: `boolean`): Reserved for future ZIP output. Individual files are stored when downloadFiles=true. ## `useApifyProxy` (type: `boolean`): Reserved for future proxy-enabled runs. ## `proxyGroups` (type: `array`): Reserved proxy groups. ## Actor input object example ```json { "urls": [ "https://www.erome.com/a/AC4FvhQh" ], "maxItems": 20, "preferredQuality": "best", "downloadFiles": false, "createZip": false, "useApifyProxy": false } ``` # 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 = { "urls": [ "https://www.erome.com/a/AC4FvhQh" ] }; // Run the Actor and wait for it to finish const run = await client.actor("serpxxx/erome-bulk-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 = { "urls": ["https://www.erome.com/a/AC4FvhQh"] } # Run the Actor and wait for it to finish run = client.actor("serpxxx/erome-bulk-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 '{ "urls": [ "https://www.erome.com/a/AC4FvhQh" ] }' | apify call serpxxx/erome-bulk-video-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=serpxxx/erome-bulk-video-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Erome Bulk Video Downloader", "description": "Extract direct video URLs, metadata, thumbnails, and format details from Erome links.", "version": "0.1", "x-build-id": "iPIQQZ2onwNvNfj3r" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/serpxxx~erome-bulk-video-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-serpxxx-erome-bulk-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/serpxxx~erome-bulk-video-downloader/runs": { "post": { "operationId": "runs-sync-serpxxx-erome-bulk-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/serpxxx~erome-bulk-video-downloader/run-sync": { "post": { "operationId": "run-sync-serpxxx-erome-bulk-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": { "urls": { "title": "URLs or IDs", "type": "array", "description": "Erome video URLs, album URLs, or IDs to process.", "items": { "type": "string" } }, "urlText": { "title": "URLs/IDs text", "type": "string", "description": "Optional fallback: one URL or ID per line." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum result rows to return.", "default": 20 }, "preferredQuality": { "title": "Preferred quality", "enum": [ "best", "1080p", "720p", "480p", "360p", "240p", "high", "low", "mp4", "hls" ], "type": "string", "description": "Quality preference when multiple formats are available.", "default": "best" }, "downloadFiles": { "title": "Download files to key-value store", "type": "boolean", "description": "When enabled, downloads the selected media file and returns storedFileUrl. Default is false to keep runs cheap.", "default": false }, "createZip": { "title": "Create ZIP archive", "type": "boolean", "description": "Reserved for future ZIP output. Individual files are stored when downloadFiles=true.", "default": false }, "useApifyProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Reserved for future proxy-enabled runs.", "default": false }, "proxyGroups": { "title": "Proxy groups", "type": "array", "description": "Reserved proxy groups.", "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```