Yupoo Album Scraper

Disclaimer: Unofficial tool — not affiliated with, sponsored by, or endorsed by Yupoo or its affiliates. Data is read from publicly accessible album and category pages only. No login. You are responsible for complying with applicable law (including GDPR where personal data appears) and the site’s terms. No warranty on accuracy or availability. Provided for informational and research use.

Yupoo album scraper for supplier photo catalogs. Paste a store, category, or album link and export the album title, a price when the title contains one, the photo count, the cover, and gallery image URLs. This Yupoo scraper is an API alternative for catalog research. Run it from Python, Node.js, or MCP and export JSON.

China wholesale catalogs	Factory offers	Product pages	Retail search
Yupoo Album Scraper ◄── you are here	1688 Scraper	Alibaba Product Scraper	AliExpress Search Scraper

When to use

• Export a Yupoo store or one category as album rows
• Keep gallery image URLs, the cover, and the photo count for a catalog file
• Read a price when the album title already contains one

Use 1688 Scraper when you need factory price ladders and MOQ instead of a photo catalog.

Key features

• Store URL, category URL, album URL, or a bare store name
• Title, price text, photo count, category, cover, and large gallery image URLs
• Subtitle text and an external link when the album author placed one there
• Optional password for a page that shows a password form
• HTTP fetch, 256 MB, no browser

Input

Field	Required	Description
startUrls	Yes	Store, category, or album links. A bare store name opens that store's album list
maxAlbums	No	Stop after this many albums. Default 40, maximum 2000
includeGallery	No	Open each album page for image URLs. Default true
maxImagesPerAlbum	No	Cap gallery URLs. Default 40. 0 keeps up to 200
password	No	Password when the page shows a password form
proxyConfiguration	No	Leave off unless a store blocks the default connection

Input example

{
  "startUrls": ["https://STORE.x.yupoo.com/categories/123456"],
  "maxAlbums": 40,
  "includeGallery": true,
  "maxImagesPerAlbum": 40
}

Output

Field	Description
albumId	Numeric album id
albumUrl	Album page
storeName	Store subdomain
title	Album title
price	Number parsed from the title when a currency symbol is present
priceText	Price as written, such as ¥168
currency	CNY, USD, or EUR
photoCount	Photos shown on the album
coverUrl	Cover image from the catalog card
imageUrls	Large gallery image URLs
categoryName	Breadcrumb category
description	Album subtitle
externalUrl	Link from the subtitle, when one is present
scrapedAt	ISO timestamp

Output example

{
  "albumId": "111",
  "albumUrl": "https://STORE.x.yupoo.com/albums/111?uid=1",
  "storeName": "STORE",
  "title": "Sample jacket ¥168",
  "price": 168,
  "priceText": "¥168",
  "currency": "CNY",
  "photoCount": 18,
  "coverUrl": "https://photo.yupoo.com/STORE/cover/medium.jpg",
  "imageUrls": ["https://photo.yupoo.com/STORE/a/big.jpg"],
  "categoryName": "Outerwear",
  "description": "Supplier note",
  "externalUrl": null,
  "scrapedAt": "2026-10-02T18:00:00+00:00"
}

Use cases

• Catalog file — one row per album with title, photo count, and gallery URLs
• Category slice — paste one category link instead of the whole store
• Single album — pass one album URL when you only need that gallery

Integration examples

Replace APIFY_TOKEN with your Apify token. The Actor name is crawloop/yupoo-album-scraper.

Node.js

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor("crawloop/yupoo-album-scraper").call({
  startUrls: ["https://STORE.x.yupoo.com/albums"],
  maxAlbums: 40,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("crawloop/yupoo-album-scraper").call(run_input={
    "startUrls": ["https://STORE.x.yupoo.com/albums"],
    "maxAlbums": 40,
})
items = client.dataset(run["defaultDatasetId"]).list_items().items
print(items)

cURL

curl "https://api.apify.com/v2/acts/crawloop~yupoo-album-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"startUrls\":[\"https://STORE.x.yupoo.com/albums\"],\"maxAlbums\":40}"

MCP and AI assistants

Use this Actor from AI tools via Apify MCP. Connect your Apify account, then call this Actor by its Store name.

Example prompts:

• "Run Yupoo Album Scraper for this category URL and return title, price, photo count, and image URLs as JSON"
• "Scrape the first 20 Yupoo albums from this store link and list titles that contain a price"
• "Pull Yupoo album rows, then run 1688 Scraper for the same product keywords to compare factory prices and MOQ"

Suite next step

After the photo catalog, run 1688 Scraper for China wholesale price ladders, MOQ, and supplier flags. For a single factory product page, use Alibaba Product Scraper.

Related Actors

• Yupoo Album Scraper ◄── you are here
• 1688 Scraper — 1688 wholesale prices, MOQ, and factories
• Alibaba Product Scraper — Alibaba product pages
• AliExpress Search Scraper — AliExpress search cards

FAQ

Does this download the image files? No. Each row stores the image URLs already published on the album page. The files stay on the original host.

What if the album title has no price? price and priceText are empty. The title, photo count, and gallery URLs are still saved.

What if the URL matches nothing? The run finishes with an empty dataset. Other URLs in the same input still run.

Can I pass a password-protected album? Set password when the page shows a password form. Public albums do not need it.