Erome Scraper & Video Downloader avatar

Erome Scraper & Video Downloader

Pricing

Pay per event

Go to Apify Store
Erome Scraper & Video Downloader

Erome Scraper & Video Downloader

Extract direct video and image URLs from Erome albums. Automatically bypass blocks and download media in bulk.

Pricing

Pay per event

Rating

0.0

(0)

Developer

Vnx0

Vnx0

Maintained by Community

Actor stats

1

Bookmarked

500

Total users

6

Monthly active users

5 days ago

Last modified

Features

Limited permissions

Share

Erome Downloader & Video Scraper: Bulk Album & Profile API

High-speed cloud extractor for Erome.com albums, high-definition videos, photos, and creator profiles. Features automatic HTTP 403 Forbidden bypass, direct CDN streaming links, ready-to-run cURL commands, and direct cloud media archiving into Apify Key-Value Store.

⚡ TL;DR

  • What it does: Extracts direct high-speed CDN links (.mp4, .jpg) and complete metadata from any Erome album, user profile, or search query.
  • Speed & Reliability: Emits structured records in under 2 seconds per album with built-in Cloudflare challenge recovery.
  • The 403 Solution: Automatically generates exact HTTP Referer headers and copy-pasteable curl commands so you can stream or download files without CDN hotlink bans.

{
"startUrls": ["https://www.erome.com/a/U3CyGACn"],
"mediaTypeFilter": "all",
"outputMode": "media",
"downloadMedia": false
}

💰 Transparent Pay-Per-Event (PPE) Pricing

You only pay for successful, verified results delivered. Apify platform compute is covered by the creator with zero hourly compute surcharge.

  • Metadata & Direct CDN Links: $0.0010 per extracted media item ($1.00 per 1,000 records).
  • Direct Cloud Archiving (KVS): $0.0050 per physical media file downloaded ($5.00 per 1,000 files).
  • Free Tier: First 50 records 100% free on any Apify Free account.
  • Zero Risk: Failed attempts, private 404/410 albums, and network retries are never billed.

⚡ Key Features: Why Choose This Erome Scraper?

  • 🎬 Direct High-Definition CDN Links: Collect direct streaming URLs (vXX.erome.com for MP4 videos and sXX.erome.com for full-resolution photos).
  • 🛡️ Automated 403 Forbidden Defense: Erome CDNs reject external download requests unless specific HTTP Referer headers are passed. Our Actor generates ready-to-run curl_command and download_headers properties on every single record.
  • 👤 Full Creator Profile Archiving: Enter any username or profile URL to paginate through every album published by a creator, extracting all associated photos and videos.
  • 🔍 Multi-Page Search Extraction: Automatically paginate through search results for any keyword or niche and collect matching galleries.
  • 📊 Instant Dual-Layer Table Views: View extracted thumbnails, video types, filenames, view counts, and uploader tags directly in the Apify Console web table without empty page errors.
  • 💾 Cloud Key-Value Store Archiving: Toggle downloadMedia to automatically stream binary .mp4 and .jpg files into your Apify cloud storage for permanent backups.
  • 🤖 AI Agent & MCP Ready: Native Model Context Protocol (MCP) tool support allows Claude Desktop, Cursor, and ChatGPT agents to query Erome autonomously.

🎯 Use-Case Recipes & Input Examples

Recipe 1: Quick Single Album Extraction (Default)

Extract all direct video and photo links from a single album into a clean table.

{
"startUrls": ["https://www.erome.com/a/U3CyGACn"],
"mediaTypeFilter": "all",
"outputMode": "media"
}

Recipe 2: Full Creator Profile Archiving

Extract all albums published by a specific creator, skipping shared reposts.

{
"usernames": ["PINKPARK"],
"maxAlbums": 30,
"postsOnly": true,
"outputMode": "media"
}

Recipe 3: Batch Album Processing

Extract multiple album URLs concurrently.

{
"startUrls": [
"https://www.erome.com/a/U3CyGACn",
"https://www.erome.com/a/86eA9xLp"
],
"outputMode": "media",
"maxConcurrency": 5
}

Recipe 4: Keyword Search & Discovery

Search Erome for specific themes, tags, or locations and extract up to 50 albums.

{
"searchQueries": ["asian", "vacation"],
"maxAlbums": 50,
"outputMode": "media"
}

Recipe 5: Videos-Only Filter (High-Definition MP4s)

Filter out photos and collect exclusively MP4 video streaming links.

{
"startUrls": ["https://www.erome.com/a/U3CyGACn"],
"mediaTypeFilter": "videos_only",
"outputMode": "media"
}

Recipe 6: Direct Cloud Archiving (Downloading Files to KVS)

Stream physical video and image files directly into your Apify Key-Value Store for permanent preservation.

{
"startUrls": ["https://www.erome.com/a/U3CyGACn"],
"downloadMedia": true,
"outputMode": "media"
}

⚙️ Input Parameters Reference

Configure your extraction using the intuitive Apify Console interface or raw JSON:

FieldTypeDefaultDescription
startUrlsArray of Strings["https://www.erome.com/a/U3CyGACn"]Target URLs to scrape (single album, creator profile, or search query). Auto-detected dynamically.
searchQueriesArray of Strings[]List of search keywords to query on Erome with automated pagination.
usernamesArray of Strings[]Creator usernames or profile links to extract all published albums from.
mediaTypeFilterString (all | videos_only | images_only)"all"Filter extracted media items. Choose videos_only to collect only MP4 videos.
outputModeString (media | albums)"media"Choose media (1 row per photo/video) or albums (1 row per album).
maxAlbumsInteger20Maximum number of albums to collect when paginating profiles or search queries.
maxItemsInteger100Safety cap on the total number of media records pushed across all processed albums.
postsOnlyBooleantrueWhen scraping creator profiles, only extract original posts and skip shared reposts.
downloadMediaBooleanfalseWhen true, physically downloads .mp4 and .jpg files into Apify Key-Value Store.
proxyConfigurationObject{"useApifyProxy": true}Proxy configuration. Apify Proxy with datacenter/residential rotation is supported.
maxConcurrencyInteger5Maximum concurrent HTTP requests (1 to 15).

📊 Output Data Dictionary

When running in media mode (default), each extracted photo or video is pushed as an independent record:

FieldTypeDescription
preview_imageString (Image URL)Direct thumbnail image rendered inside Apify Console table views.
direct_urlString (URL)High-speed CDN link to the raw .mp4 video or .jpg photo.
media_typeStringvideo or image.
filenameStringOriginal CDN file identifier.
extensionStringFile extension (mp4, jpg, png, webm).
album_idStringUnique Erome album identifier (e.g. U3CyGACn).
album_titleStringClean, unescaped title with trailing hashtags stripped.
album_urlString (URL)Canonical link to the album on Erome.
uploaderStringUsername of the content creator.
uploader_urlString (URL)Direct link to creator profile.
viewsStringTotal view count (e.g. 14.2K).
likesStringTotal like / favorite count.
item_indexNumberSequential position of this media file within the album.
media_countNumberTotal media items contained in the album.
tagsArray of StringsCategorical tags applied to the album.
curl_commandStringCopy-pasteable terminal command to download the file locally without 403 errors.
download_headersObjectHTTP headers (Referer, User-Agent) required for direct downloads.
downloaded_file_urlString (URL)Public Apify Key-Value Store URL (present when downloadMedia: true).
created_atString (ISO Date)Upload timestamp parsed from media versioning headers.
scraped_atString (ISO Date)Timestamp of extraction.

Sample JSON Output Item

{
"preview_image": "https://s94.erome.com/512/nqKmbvAz.jpg",
"direct_url": "https://v94.erome.com/512/Z64ancVH_720p.mp4",
"media_type": "video",
"filename": "Z64ancVH_720p",
"extension": "mp4",
"album_id": "U3CyGACn",
"album_title": "Asian wild babe sloppy blowjob",
"album_url": "https://www.erome.com/a/U3CyGACn",
"uploader": "PINKPARK",
"uploader_url": "https://www.erome.com/PINKPARK",
"views": "18.4K",
"likes": "312",
"item_index": 1,
"media_count": 6,
"tags": ["amateur", "asian", "creampie"],
"curl_command": "curl -H \"Referer: https://www.erome.com/\" -O \"https://v94.erome.com/512/Z64ancVH_720p.mp4\"",
"download_headers": {
"Referer": "https://www.erome.com/",
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:120.0) Gecko/20100101 Firefox/120.0"
},
"downloaded_file_url": null,
"created_at": "2026-04-06T13:53:18.000Z",
"scraped_at": "2026-11-16T03:00:00.000Z"
}

🛠️ How to Bypass the HTTP 403 Forbidden CDN Error

Erome protects its content delivery servers (sXX.erome.com and vXX.erome.com) with anti-hotlinking rules. If you attempt to open a direct media link in a browser tab or download it with plain wget, the CDN responds with 403 Forbidden.

Our Actor solves this in two ways:

  1. Option A: The Automated Cloud Download: Toggle "downloadMedia": true. The Actor fetches the file using authentic headers and saves it directly to your Apify Key-Value Store, providing clean, non-restricted public download links.
  2. Option B: Copy-Pasteable cURL Command: Every item in the dataset contains a curl_command field. Simply copy the command and paste it into your terminal:
    $curl -H "Referer: https://www.erome.com/" -O "https://v94.erome.com/512/Z64ancVH_720p.mp4"
  3. Option C: Custom Python Downloader:
    import requests
    url = "https://v94.erome.com/512/Z64ancVH_720p.mp4"
    headers = {
    "Referer": "https://www.erome.com/",
    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
    }
    response = requests.get(url, headers=headers, stream=True)
    with open("video.mp4", "wb") as f:
    for chunk in response.iter_content(chunk_size=8192):
    f.write(chunk)

💻 Programmatic API Integration

You can trigger this Actor programmatically using the official Apify Client in Python, JavaScript, or direct cURL REST API calls.

Node.js / JavaScript

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({
token: 'YOUR_APIFY_TOKEN',
});
const run = await client.actor('erome-downloader').call({
startUrls: ['https://www.erome.com/a/U3CyGACn'],
mediaTypeFilter: 'all',
outputMode: 'media',
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Extracted ${items.length} media items:`, items);

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_APIFY_TOKEN')
run_input = {
'startUrls': ['https://www.erome.com/a/U3CyGACn'],
'mediaTypeFilter': 'all',
'outputMode': 'media',
}
run = client.actor('erome-downloader').call(run_input=run_input)
dataset_items = client.dataset(run['defaultDatasetId']).list_items().items
for item in dataset_items:
print(f"[{item.get('media_type')}] {item.get('album_title')} -> {item.get('direct_url')}")

cURL REST API

curl "https://api.apify.com/v2/acts/erome-downloader/runs?token=YOUR_APIFY_TOKEN" \
-X POST \
-H "Content-Type: application/json" \
-d '{
"startUrls": ["https://www.erome.com/a/U3CyGACn"],
"outputMode": "media"
}'

🤖 AI Agent & Apify MCP Integration

This Actor is fully compatible with the Model Context Protocol (MCP), allowing autonomous coding agents like Claude Desktop, Cursor, and custom LLM agent pipelines to query and extract Erome media.

Claude Desktop MCP Configuration

Add the Apify MCP server to your claude_desktop_config.json:

{
"mcpServers": {
"apify": {
"command": "npx",
"args": ["-y", "@apify/mcp-server"],
"env": {
"APIFY_TOKEN": "YOUR_APIFY_TOKEN"
}
}
}
}

Prompting AI Agents

"Extract all video download links and view counts from the Erome creator @PINKPARK using the erome-downloader actor. Format the response as a markdown table with direct streaming links and curl download commands."


❓ Frequently Asked Questions (FAQ)

What is the difference between media and albums output mode?

  • media mode (Recommended): Emits one dataset record per photo or video. This gives you flat columns in the Apify Console web table and makes CSV or Excel exports immediately usable.
  • albums mode: Emits one record per album, with all media items packed into a nested array. This is ideal if you are syncing album-level objects into a document database (MongoDB, Elasticsearch).

Can I download full albums as a single ZIP archive?

When downloadMedia: true is enabled, all files are stored in the run's default Key-Value Store. From the Apify Console Output tab, you can click "Download all keys" or use the Key-Value Store API to download the entire collection in bulk.

What happens if an album has been deleted or copyrighted (HTTP 410)?

The Actor detects HTTP 410 and 404 responses gracefully, logging an informative warning without crashing the entire run. If you are scraping a list of 50 albums and 2 are removed, the remaining 48 albums will process and save normally.

Are residential proxies required?

For small runs (1–5 albums), datacenter proxies or standard Apify Proxy works reliably. For high-volume profile archiving or hundreds of concurrent requests, residential proxies are recommended to prevent Cloudflare challenge rate limits.


⚠️ Performance Limits & Terms of Service

  • Rate Limits: To maintain platform stability and protect Erome's infrastructure, concurrency is bounded at 15 concurrent requests.
  • Fair Bandwidth Usage: Please respect content creators and bandwidth limitations. Do not hammer servers with excessive unthrottled requests.
  • Compliance: This software is intended for data archiving, research, and personal media preservation. Users are responsible for ensuring compliance with Erome.com Terms of Service and applicable local copyright laws.

📄 License & Commercial Terms

Commercial Pay-Per-Event Software published on the Apify Store. Platform compute is included with event billing. For enterprise integrations, custom data pipelines, or high-volume dedicated instances, contact the publisher via the Apify Console support tab.