# Temu Product Scraper — Prices, Ratings & 20 Countries (`sourcelab/temu-product-scraper`) Actor

Scrape Temu products by URL or goods ID (price, currency, rating, review count, images, video, category path, material) and Temu category pages (120 products: price, original price, discount, units sold). US, UK, EU, Mexico, Japan storefronts. No login, no browser. Pay per result.

- **URL**: https://apify.com/sourcelab/temu-product-scraper.md
- **Developed by:** [Roudaut Romain](https://apify.com/sourcelab) (community)
- **Categories:** E-commerce
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.03 / 1,000 products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Temu Product Scraper — Prices, Ratings & 20 Countries

Get **Temu product data** from product URLs, goods IDs or category pages: current price and currency, original price and discount, units sold, rating and review count, all product images, product video, full category path, material — from the **US store or 19 other Temu storefronts** (UK, Germany, France, Italy, Spain, Mexico, Japan…). **No login, no cookies, no browser.**

**You pay per result delivered. Failed, removed or blocked items are never charged.**

### What you get

**Products** (`type: "product"`) — one row per product URL or ID:

| Group | Fields |
|---|---|
| Identity | `goodsId`, `url` (canonical), `title`, `region` |
| Price | `price`, `currency`, `availability`, `condition` |
| Ratings | `rating` (0-5), `reviewCount`, `recentReviews` (rating + date of the latest reviews — anonymous, no names or texts) |
| Category | `categoryPath` (e.g. `["Pet Supplies", "Pet Beds & Bedding"]`), `categoryIds`, `categoryUrls`, `keywords` |
| Content | `mainImage`, `images` (full gallery), `videoUrl`, `videoUploadedAt`, `material`, `description` |
| From a category (when `fetchDetailsForCategories` is on) | `originalPrice`, `discountPercent`, `soldText`, `soldCount`, `listingCategory`, `listingPosition` |

**Category results** (`type: "listing"`) — up to 120 products per category page: `goodsId`, `title`, `price`, `originalPrice`, `discountPercent`, `currency`, `soldText` ("45K+ sold") and `soldCount` (45000), `rating`, `reviewCount`, `image`, `videoUrl`, `category`, `categoryId`, `position`, `url`.

### Input

```json
{
  "products": [
    "https://www.temu.com/-g-601099513224343.html",
    "https://www.temu.com/uk/-g-606384619891066.html",
    "601099780807969"
  ],
  "categories": ["https://www.temu.com/pet-supplies-o3-320.html", "248"],
  "maxResultsPerCategory": 120,
  "fetchDetailsForCategories": false,
  "region": "us"
}
```

- `products`: Temu product URLs (`…-g-<id>.html`, `goods.html?goods_id=<id>`) or bare goods IDs. A URL with a country path (`/uk/`, `/de/`…) keeps its own country.
- `categories`: Temu category URLs (`…-o3-<id>.html`, `category.html?opt_id=<id>`) or category IDs — top-level or sub-categories.
- `fetchDetailsForCategories`: turn every category result into a full product record (billed as `product`).
- `region`: storefront for prices, currency and titles (`us`, `uk`, `ca`, `au`, `de`, `fr`, `it`, `es`, `nl`, `mx`, `jp`, …).

### Typical uses

- **Price monitoring** of Temu products, and cross-border price comparison (same goods ID in USD, GBP, EUR, MXN…).
- **Product research / dropshipping**: best sellers of a category with units sold, discount and rating.
- **Catalogue matching**: full image gallery, category path and material for each goods ID.

### How much does it cost?

Pay per event: you pay only for results delivered. Platform usage (compute, residential proxy) is included. Failed, blocked or removed items are never charged.

| What you get | Event | Price | Per 1,000 |
|---|---|---|---|
| Product record | `product` | $0.0029 | $2.90 |
| Category result | `listing` | $0.0015 | $1.50 |
| Optional: one product looked up on 1688 (`findFactoryOn1688`) | `image-search`, billed by [1688 Image Search](https://apify.com/sourcelab/1688-image-search) in your account | $0.0045 | $4.50 |
| Actor start | `apify-actor-start` | $0.00005 per GB of memory, once per run | — |

Example: one category (120 results) ≈ **$0.18**; with 10 factory lookups on 1688 ≈ $0.18 + $0.045 = **$0.23**.

Set a maximum cost per run when you start the Actor (Console or API): it stops cleanly when the limit is reached.

### Find the factory on 1688 (optional)

Turn on **Find the factory on 1688** and each Temu product (up to *Max factory lookups*, 10 by default) is searched on **1688.com by its main image**, with our [1688 Image Search](https://apify.com/sourcelab/1688-image-search) Actor. The product comes back with:

- `factoryMatches[]` — the most similar 1688 offers (5 by default, sponsored results excluded): `price` in CNY, `moq`, `sales`, `repurchaseRate`, `supplierName`, `supplierMemberId`, `supplierProvince`, `supplierYears`, `superFactory`, `similarityScore`, `shopUrl`, `imageUrl`, `url`;
- `factoryPriceMinCny`, `factoryPriceMedianCny` and `factoryPriceMedian` (median 1688 price converted to the product's currency with the day's ECB rate, `fxRateCnyToCurrency`, `fxDate`);
- `retailToFactoryRatio` (retail price ÷ median factory price) and `estimatedGrossMarginPercent`;
- `factorySearch.status`: `ok`, `no_match`, `failed` or `skipped` (with the reason).

**The margin is a rough gross estimate**: it ignores shipping, duties, VAT and platform fees, and visual similarity is not a guarantee of the same product. Use it to shortlist, then check the offers.

Cost: one `image-search` event ($0.0045) per product looked up, billed by 1688 Image Search in your own Apify account, on top of this Actor's events. *Max factory lookups* caps it ($0.045 at the default of 10), and the run's spending limit is respected. Off by default: nothing changes for runs that don't enable it.

```json
{"findFactoryOn1688": true, "maxFactoryLookups": 10, "factoryMatchesPerProduct": 5}
```

Real output (one product, `factoryMatches` shortened to one offer):

```json
{
  "type": "listing",
  "goodsId": "601099530031372",
  "title": "Cat Beds for Indoor Cats, Non-Slip Puppy Bed Gray Cat Nest Comfortable Pet House Cat Tent",
  "price": 9.47,
  "currency": "USD",
  "image": "https://img.kwcdn.com/product/Fancyalgo/VirtualModelMatting/ba34db42c4368b8328c44b784fc93acd.jpg",
  "factoryMatches": [
    {
      "rank": 2,
      "offerId": "969293332351",
      "title": "现货猫窝保暖加厚猫房子封闭式床屋别墅狗狗窝冬天保暖和宠物睡垫",
      "price": 16.5,
      "priceLabel": "",
      "currency": "CNY",
      "moq": 1,
      "moqLabel": "1件起批",
      "sales": 3100,
      "salesLabel": "3100+件",
      "repurchaseRate": "43%",
      "supplierName": "菏泽鲁西新区小懒狗工艺品厂",
      "supplierMemberId": "b2b-22204998876398d9a1",
      "supplierLoginId": "菏泽小懒狗工艺品",
      "supplierProvince": "山东",
      "supplierYears": 2,
      "superFactory": false,
      "factoryInspected": false,
      "similarityScore": 0.2059,
      "shopUrl": "https://shop74049f7v5n557.1688.com",
      "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01MNHEFO26IidAdDpnG_!!2220499887639-0-cib.jpg",
      "url": "https://detail.1688.com/offer/969293332351.html"
    }
  ],
  "factoryPriceMinCny": 16.5,
  "factoryPriceMedianCny": 23.9,
  "factoryPriceMedian": 3.57,
  "fxRateCnyToCurrency": 0.14939,
  "fxDate": "2026-10-13",
  "retailToFactoryRatio": 2.65,
  "estimatedGrossMarginPercent": 62.3,
  "factorySearch": {
    "status": "ok",
    "image": "https://img.kwcdn.com/product/Fancyalgo/VirtualModelMatting/ba34db42c4368b8328c44b784fc93acd.jpg",
    "runId": "Dlb9eI0OunmYetFWg"
  }
}
```

### Output example

Real output from a run on 13 Oct 2026 (selected fields):

```json
{
  "type": "product",
  "goodsId": "606384619891066",
  "title": "[HTC Official Flagship] HTC NE79 MINI True Wireless Earbuds, In-Ear Noise Cancelling, Color-Block Style, Fashionable *, Compact And Lightweight Zero-*, Long * Sports Gaming Earphones, Top-Tier *",
  "price": 7.87,
  "currency": "USD",
  "rating": 4.8,
  "reviewCount": 1118,
  "categoryPath": [
    "Electronics",
    "Headphones, Earbuds & Accessories"
  ],
  "mainImage": "https://img.kwcdn.com/product/fancy/527886e4-81d8-4112-a81a-d55a5b41e76e.jpg",
  "region": "us",
  "url": "https://www.temu.com/htc-official-flagship-htc-ne79-mini-true-wireless-earbuds-in-ear-noise-cancelling-color-block-style-fashionable--compact-and-lightweight--wear-long-lasting-sports-gaming-headphones--quality-high-v-recommendation-g-606384619891066.html"
}
```

### FAQ

**Do I need an account on the marketplace?**
No. The Actor reads public pages and endpoints: no login, no cookies, no phone number.

**Can I search Temu by keyword?**
No: Temu serves search results only to logged-in shoppers. Use category pages (top-level or sub-categories) instead.

**Which currency and country?**
Choose the storefront with `region` (US, UK, Germany, France, Japan… 20 countries); prices come in that store's currency.

**How do I find the supplier of a Temu product?**
Turn on *Find the factory on 1688*, or pass `mainImage` to 1688 Image Search yourself.

**Can I run it on a schedule or from my code?**
Yes. Schedule it in Apify Console, call it through the Apify API (JavaScript, Python, HTTP), or connect it to Make, Zapier, n8n or Google Sheets. Export as JSON, CSV or Excel.

### Limits (read before buying)

- **Keyword search is not supported.** Temu only serves search results to logged-in shoppers; this Actor never logs in. Use category pages instead (top-level or sub-categories).
- Product records come from Temu's public product page: **no SKU/variant matrix, no seller/store name, no shipping estimate, no review texts.** Units sold, original price and discount come from category pages (`fetchDetailsForCategories`).
- Temu masks some brand and claim words with `*` in its own titles and descriptions; the Actor returns them as published.
- Category pages show the first **120 products** (Temu's default "Top sales" order).
- Residential proxies are used by default (US exits; the store country is chosen with `region`).

Public marketplace data only, no personal data. Not affiliated with PDD Holdings or Temu.

### Chain it with

| Take this output field | Feed it to | Input field |
|---|---|---|
| `mainImage` (products) or `image` (category rows) | [1688 Image Search](https://apify.com/sourcelab/1688-image-search) | `imageUrls` — or let this Actor do it with `findFactoryOn1688` |

Values are accepted exactly as this Actor outputs them (full URL or bare ID). In code, start the next Actor with the dataset of this run, or use an Apify integration (*Actor-to-Actor*) to chain them automatically.

#### More SourceLab scrapers

- **[1688 Image Search](https://apify.com/sourcelab/1688-image-search)** — find the factory behind a Temu product: pass its `mainImage` and get the 1688 offers that look the same, with CNY price and MOQ.
- **[1688 Wholesale Scraper](https://apify.com/sourcelab/1688-wholesale-scraper)** — check the wholesale cost in China: 1688 factory prices and MOQ for the same kind of product.
- **[AliExpress Scraper](https://apify.com/sourcelab/aliexpress-product-scraper)** — check the retail price abroad: per-variant price and stock, shipping fees and delivery days to your country, review summary.
- **[Alibaba.com Product Scraper](https://apify.com/sourcelab/alibaba-product-scraper)** — the export side of Chinese factories: USD quantity price tiers, MOQ, lead times, certifications and supplier credentials on Alibaba.com.
- **[Taobao & Tmall Product Scraper](https://apify.com/sourcelab/taobao-product-scraper)** — compare with Chinese retail on Taobao & Tmall: current price, seller DSR scores and credit level, rating breakdown.
- **[JD.com Product Scraper](https://apify.com/sourcelab/jd-product-scraper)** — compare with China's B2C retail on JD.com: real CNY price (when confirmed), UPC barcode, specification table, self-operated flag.
- **[1688 Supplier Scraper](https://apify.com/sourcelab/1688-supplier-scraper)** — found a product on 1688? get the supplier's full catalog and company profile (Trade Pass years, buyer retention rate, certificates).

# Actor input Schema

## `products` (type: `array`):

One per line: Temu product URLs (…-g-601099513224343.html, goods.html?goods_id=…, with or without a country path such as /uk/) or bare goods IDs.

## `categories` (type: `array`):

Optional. Temu category pages (…-o3-320.html, category.html?opt_id=320) or bare category IDs. Each returns up to 120 products with price, original price, discount, units sold, rating and review count.

## `maxResultsPerCategory` (type: `integer`):

Temu renders the first 120 products of a category page.

## `fetchDetailsForCategories` (type: `boolean`):

Turn category results into full product records (all images, category path, material, video) merged with the listing's original price, discount and units sold — billed as 'product' instead of 'listing'.

## `region` (type: `string`):

Prices, currency, titles and ratings come from this country's Temu store. A product URL that already contains a country path (e.g. /uk/) keeps its own country.

## `maxConcurrency` (type: `integer`):

Parallel requests.

## `proxyConfiguration` (type: `object`):

Temu blocks datacenter IPs. Residential proxies are required; the Actor uses US residential exits (the storefront country is chosen with the 'region' field, not the proxy).

## `findFactoryOn1688` (type: `boolean`):

For each product delivered (up to 'Max factory lookups'), search its main image on 1688.com with our 1688 Image Search Actor and add factoryMatches (CNY price, MOQ, supplier, link), the median factory price converted to the product's currency, retailToFactoryRatio and an estimated gross margin. Runs 1688 Image Search in your account: one image-search event ($0.0045) per product looked up, on top of this Actor's own events. Off by default.

## `maxFactoryLookups` (type: `integer`):

Upper bound on the number of products searched on 1688 in this run (the first products delivered). Caps the extra cost at $0.0045 × this number.

## `factoryMatchesPerProduct` (type: `integer`):

Most similar 1688 offers kept per product (sponsored results excluded). Up to 20 always costs a single image-search event.

## Actor input object example

```json
{
  "products": [
    "https://www.temu.com/-g-601099513224343.html",
    "606384619891066"
  ],
  "categories": [],
  "maxResultsPerCategory": 120,
  "fetchDetailsForCategories": false,
  "region": "us",
  "maxConcurrency": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "findFactoryOn1688": false,
  "maxFactoryLookups": 10,
  "factoryMatchesPerProduct": 5
}
```

# Actor output Schema

## `products` (type: `string`):

No description

## `overview` (type: `string`):

No description

## `stats` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "products": [
        "https://www.temu.com/-g-601099513224343.html",
        "606384619891066"
    ],
    "categories": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("sourcelab/temu-product-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "products": [
        "https://www.temu.com/-g-601099513224343.html",
        "606384619891066",
    ],
    "categories": [],
}

# Run the Actor and wait for it to finish
run = client.actor("sourcelab/temu-product-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "products": [
    "https://www.temu.com/-g-601099513224343.html",
    "606384619891066"
  ],
  "categories": []
}' |
apify call sourcelab/temu-product-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,sourcelab/temu-product-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Dc5YjIz8JhbPKXjgx/builds/eOemz0xKOKmKfz0ZK/openapi.json