📸 Yupoo Album Downloader & Zipper Download and compress all product images from any Yupoo album into a single .zip file. This Actor is ideal for suppliers, importers, and automation workflows that require fast, bulk image extraction from Yupoo. --- ## ⚠️ IMPORTANT: This code only processes individual albums DO NOT use category links! We have noticed that some users try to download images using links like: - ❌ https://xxxxxx.x.yupoo.com/categories - ❌ https://xxxxxx.x.yupoo.com/albums ALWAYS use the direct link to the specific album: ### Correct structure: Categories > Products > Album Correct examples: - ✅ https://martinreps.x.yupoo.com/albums/205649537?uid=1 - ✅ https://martinreps.x.yupoo.com/albums/205649755?uid=1 Incorrect examples: - ❌ https://xxxxxxxx.x.yupoo.com/categories - ❌ https://xxxxxxxx.x.yupoo.com/albums ## 🚀 Features - 🔍 Automatically scrapes all product image URLs from a Yupoo album - ⬇️ Downloads each image - 📦 Compresses all images into a single .zip file - 🧾 Returns metadata and a downloadable ZIP in the output --- ### 💡 Pro Tip: Use threads to speed up bulk album downloads If you're working with multiple Yupoo album URLs, you can significantly reduce execution time by using Python threads or async tasks to process them in parallel. > 🧵 Each thread can call the Actor with a different product_url, allowing simultaneous scraping and downloading. This approach is ideal for: - Importers scraping entire catalogs - Agencies managing image backups for multiple clients - Developers automating product intake workflows --- ## 📥 Input ### product_url (required) The full URL of the Yupoo album to scrape. Example: https://scarlettluxury.x.yupoo.com/albums/189703081?uid=1 ## 📤 Output ### 🗂️ ZIP A downloadable .zip archive containing all extracted images. ### 📄 OUTPUT (JSON) Metadata about the download operation: json { "product_url": "https://example.x.yupoo.com/albums/12345678?uid=1", "total_downloaded": 12, "zip_file": "12345678.zip", "image_urls": [ "https://photo.yupoo.com/...jpg", "...more image URLs..." ] } ## 🧪 Example: Trigger the Actor and Download the ZIP python import time import requests API_TOKEN = "YOUR_API_TOKEN" ACTOR_ID = "pizani~yupoo-images-downloader" PRODUCT_URL = "URL_ALBUM" #EX: "https://example.x.yupoo.com/albums/12341243?uid=1" # Start the Actor run_resp = requests.post( f"https://api.apify.com/v2/acts/{ACTOR_ID}/runs?token={API_TOKEN}", json={"product_url": PRODUCT_URL} ) run_id = run_resp.json()["data"]["id"] # Wait for completion status_url = f"https://api.apify.com/v2/actor-runs/{run_id}?token={API_TOKEN}" while True: status = requests.get(status_url).json()["data"]["status"] if status in {"SUCCEEDED", "FAILED", "ABORTED", "TIMED-OUT"}: break time.sleep(5) # Get ZIP URL and download kv_id = requests.get(status_url).json()["data"]["defaultKeyValueStoreId"] zip_url = f"https://api.apify.com/v2/key-value-stores/{kv_id}/records/ZIP?disableRedirect=true&token={API_TOKEN}" zip_response = requests.get(zip_url) with open("album_images.zip", "wb") as f: f.write(zip_response.content) print("✅ Download complete: album_images.zip") --- ## 🛠️ How It Works 1. Extracts all product images from the album page 2. Downloads each image 3. Stores images in a temp folder, then zips them 4. Uploads the ZIP file and metadata to Apify Key-Value Store 5. Cleans up temporary files --- ## 📌 Use Cases - Sourcing product images from suppliers for e-commerce - Backing up full visual catalogs - Automating image collection from Yupoo stores --- ## 📎 Notes - Yupoo blocks direct access to images without a valid referer — this Actor handles that automatically - Some albums may use lazy-loading for images — this script includes a delay to ensure all content is fully rendered - The ZIP file is named based on the album’s ID from the URL --- ### 🧵 Bonus: Example to run multiple downloads with 3 threads You can use Python and ThreadPoolExecutor to launch up to 3 parallel executions of this Actor: python import requests from concurrent.futures import ThreadPoolExecutor API_TOKEN = 'APIFY_API_TOKEN_AQUI' ACTOR_ID = 'pizani~yupoo-images-downloader' # Use ~ instead of / for the API URL urls = [ "https://store1.x.yupoo.com/albums/11111111", "https://store2.x.yupoo.com/albums/22222222", "https://store3.x.yupoo.com/albums/33333333" ] def run(url): requests.post( f"https://api.apify.com/v2/acts/{ACTOR_ID}/runs?token={API_TOKEN}", json={"input": { "product_url": url, "output_dir": "/mnt/data/yupoo" # Change if needed }} ) with ThreadPoolExecutor(max_workers=3) as executor: executor.map(run, urls) 📌 Tip: Increase max_workers if your Apify plan supports higher concurrency.