Yupoo Album Scraper — bulk download photos & pack to ZIP Quickly extract every photo from a single Yupoo album and export them as one downloadable .zip. Designed for resellers, sourcing teams, and automation pipelines that need fast, reliable mass image pulls. ## ⚠️ Album-only extractor This tool is built specifically to process individual album pages. Give it a direct album link (URL must include /albums/…) and it will crawl the album — including additional pages — and fetch all images. Valid example URLs * https://sellername.x.yupoo.com/albums/123456?uid=1 * https://anotherstore.x.yupoo.com/albums/987654 Not supported * Store homepage, categories listing, or a generic store URL (e.g. https://sellername.x.yupoo.com/ or .../categories) — the actor will not return album images from those. --- ## What it does * Crawls a Yupoo album (handles pagination) and locates every image. * Downloads photos in their full available resolution. * Uses concurrent fetches to finish faster. * Bundles all images into a single ZIP archive named after the album ID (e.g. 123456.zip). * Produces a JSON summary with run details and the list of downloaded image URLs. --- ## Inputs ### albumUrl — required The complete album URL to process. Example payload: json { "albumUrl": "https://sellername.x.yupoo.com/albums/123456?uid=1" } No other fields are mandatory — keep it simple. --- ## Outputs ### 1) ZIP archive (images) All images are stored together as: <albumId>.zip For the album 123456 the archive will be 123456.zip. The actor writes this file to the key-value store so you can download it after the run. ### 2) JSON summary (metadata) A JSON object is saved to the output dataset / KV store. Example structure: json { "album_url": "https://sellername.x.yupoo.com/albums/123456?uid=1", "total_downloaded": 120, "zip_file": "123456.zip", "image_urls": [ "https://photo.yupoo.com/sellername/aaaa1111.jpg", "https://photo.yupoo.com/sellername/bbbb2222.jpg", "https://photo.yupoo.com/sellername/cccc3333.jpg" ] } This record is placed into the run’s dataset and also saved as a KV key (e.g. OUTPUT). There’s also a separate INFO record containing run metadata (run id, store id, timestamps) for debugging and automation. --- ## Implementation notes / gotchas * Yupoo sometimes enforces a Referer header for image delivery — the actor sets a suitable referer automatically. * Pagination inside multi-page albums is detected and followed. * The ZIP filename is derived from the album ID parsed from the input URL. * If an Apify/actor proxy is available it will be used; otherwise the scraper connects directly. --- ## Example: run & download (Python) Short example that starts the actor, polls until it finishes, reads the OUTPUT metadata, then downloads the ZIP: python import time, requests API_TOKEN = "YOUR_API_TOKEN" ACTOR_ID = "bytebeast~yupoo-album-scraper" ALBUM_URL = "https://sellername.x.yupoo.com/albums/123456?uid=1" # Start r = requests.post( f"https://api.apify.com/v2/acts/{ACTOR_ID}/runs?token={API_TOKEN}", json={"albumUrl": ALBUM_URL} ) r.raise_for_status() run_id = r.json()["data"]["id"] print("Run started:", run_id) # Poll status_url = f"https://api.apify.com/v2/actor-runs/{run_id}?token={API_TOKEN}" while True: s = requests.get(status_url); s.raise_for_status() st = s.json()["data"]["status"] print("Status:", st) if st in ("SUCCEEDED", "FAILED", "ABORTED", "TIMED-OUT"): break time.sleep(3) if st != "SUCCEEDED": raise SystemExit("Run did not succeed") kv_id = s.json()["data"]["defaultKeyValueStoreId"] # Get OUTPUT summary out = requests.get( f"https://api.apify.com/v2/key-value-stores/{kv_id}/records/OUTPUT?disableRedirect=true&token={API_TOKEN}" ) out.raise_for_status() summary = out.json()[0] zip_name = summary["zip_file"] # Download ZIP zip_resp = requests.get( f"https://api.apify.com/v2/key-value-stores/{kv_id}/records/{zip_name}?disableRedirect=true&token={API_TOKEN}" ) zip_resp.raise_for_status() with open(zip_name, "wb") as f: f.write(zip_resp.content) print("Downloaded:", zip_name) --- ## Common use cases * Rapidly collect supplier product images for your ecommerce store or PIM. * Archive a visual album before it changes. * Feed product photos into an image-processing or listing-creation pipeline. * Batch-download multiple albums by calling the actor programmatically. --- ## Want tweaks or extra features? I can customize the scraper to: * Accept category pages and discover albums automatically * Merge several album ZIPs into one archive * Capture titles, captions, or product metadata alongside images * Integrate directly with cloud storage (S3, Google Drive), or push results to your API