📸 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.

---

🚀 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_dir (required)

The local path where images will be saved and zipped.
Default: /mnt/data/yupoo

---

📤 Output

🗂️ ZIP

A downloadable .zip archive containing all extracted images.

📄 OUTPUT (JSON)

Metadata about the download operation:

{
  "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..."
  ]
}

---

🛠️ 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:

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.