# Temu Product Scraper | Prices Sold Global (`lentic_clockss/temu-scraper`) Actor

Scrape Temu (www.temu.com) — keyword search, category & channel PLPs, home discover & PDP across US, UK, EU, Asia & more. Extract goodsId, prices, ratings, sold counts, images. Export Excel/CSV/JSON for e-commerce research & price monitoring.

- **URL**: https://apify.com/lentic\_clockss/temu-scraper.md
- **Developed by:** [kane liu](https://apify.com/lentic_clockss) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 3 total users, 3 monthly users, 50.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.20 / 1,000 results

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

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Temu Product Scraper | Prices Sold Global

**Scrape Temu product listings, keyword search, category pages, channels, and product details across global regional storefronts — then download structured e-commerce data as Excel, CSV, or JSON.**

Use this Actor as a practical **Temu product data API** for marketplace research, price monitoring, sold-count tracking, and competitive analysis on [temu.com](https://www.temu.com/) (`www.temu.com/{region}` for PH, UK, DE, FR, AU, and 40+ path codes; US often uses the bare www root). Choose a mode, set region and filters, and get Dataset rows with `goodsId`, prices, titles, images, ratings, and sold labels.

- Scrape **Temu keyword search** (`search_result.html`), **category PLP** (`-o3-{optId}.html`), **channel pages** (best-sellers, new-in, lightning deals, clearance), **home discover**, and **product PDP**
- Cover **global regions**: US, UK, EU, Asia-Pacific, LATAM and more via `www.temu.com/{region}`
- Extract **goodsId, title, sale/retail price, currency, images, badges, rating, sold label, mallId**
- Optional **PDP enrich** (`enrichDetails` + `enrichLimit`) for gallery images, description, and mall signals
- Filter listings with **sort**, **minPrice / maxPrice**, **refine**, multi-**keywords**, **page / maxPages**
- Export to **Excel / CSV / JSON**, or connect Make, n8n, Zapier, Python, or the Apify API
- **Pay per event** — Actor start + each Dataset result; **platform usage is included** (you do not pay separate Apify compute on top)

> **Unofficial tool.** This Actor is not affiliated with, endorsed by, or sponsored by Temu / Whaleco Inc. It collects publicly reachable product listing and detail surfaces and does **not** log in, checkout, place orders, or access private accounts. Checkout/payment flows and **auto-solving** Temu security verification (`bgn_verification` / Phantom) are out of scope.

***

### What does the Temu Product Scraper do?

[Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper) lets you **extract structured product data from Temu regional storefronts** without running your own browser and proxy fleet. Give it a keyword, category `optId` / slug / URL, channel, product URL, or `goodsId`, then start a run.

Under the hood, the Actor:

1. Validates your input (mode, region, query / category / channel / product, filters)
2. Enforces free-tier caps when you are on a free Apify plan
3. Calls a managed Cloud Run worker that opens Temu with a real browser session (Bright Data Scraping Browser when configured)
4. Parses product links, listing BFF payloads (`goods_list`), and PDP `rawData` when available
5. Pushes Dataset rows ready for Excel / CSV / JSON export
6. Writes `RUN_SUMMARY` (and `ERROR_SUMMARY` on failure) to the key-value store

You run it like any other Apify Actor — schedule it, call it from the API, or plug it into automations.

***

### What Temu data can I extract?

| Data | Home | Keyword search | Channel | Category PLP | Product PDP |
| --- | :---: | :---: | :---: | :---: | :---: |
| goodsId / URL | ✅ | ✅ | ✅ | ✅ | ✅ |
| Title / name | ✅ | ✅ | ✅ | ✅ | ✅ |
| Sale / retail price | ✅ | ✅ | ✅ | ✅ | ✅ |
| Currency / region | ✅ | ✅ | ✅ | ✅ | ✅ |
| image / images gallery | ✅ / enrich | ✅ / enrich | ✅ / enrich | ✅ / enrich | ✅ |
| Badges (Top pick, Local, …) | ✅ | ✅ | ✅ | ✅ | — |
| Rating / sold label | ✅ | ✅ | ✅ | ✅ | — |
| mallId / description | enrich | enrich | enrich | enrich | ✅ |
| categorySlug / optId | — | — | — | ✅ | — |
| channel | — | — | ✅ | — | — |

***

### Why scrape Temu?

Temu is one of the largest global value marketplaces, with regional path codes, deep category trees (`-o3-`), promotional channels, and frequent price changes. Teams scrape Temu for **price monitoring**, **sold-count / ranking signals**, **assortment research**, and **dropshipping / supplier research**:

- Monitor **keyword search** and **category PLPs** across electronics, home, clothing, beauty, and 30+ sitemap verticals
- Track **channel surfaces** — best sellers, 5-star, new in, lightning deals, clearance
- Pull **home discover** feeds for regional assortment snapshots
- Enrich rows with **PDP** title, prices, image galleries, and store (`mallId`) signals
- Feed BI dashboards, pricing tools, Google Sheets, BigQuery, or AI agents with clean rows

Compared with keyword-only Temu scrapers, this Actor covers **home + search + channel + category taxonomy + PDP** across **many regional path codes** in one input surface — with sort, price filters, pagination, and optional PDP enrich.

***

***

### More Actors like this

Need another marketplace or a different vertical? Use a **dedicated Actor** below for structured fields. Use this Actor for **Temu** product listings — keyword search, categories, channels, home discover, and PDP across global regions.

#### Similar e-commerce scrapers

- [Shopee Search Scraper](https://apify.com/lentic_clockss/shopee-search-scraper)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Amazon Search Scraper](https://apify.com/lentic_clockss/amazon-search-results-collector)
- [Lazada Scraper](https://apify.com/lentic_clockss/lazada-ph-search-results-collector)
- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)
- [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
- [MercadoLibre Scraper](https://apify.com/lentic_clockss/mercadolibre-scraper)
- [Coupang Product Scraper](https://apify.com/lentic_clockss/coupang-scraper)
- [1688 Global Product Search Scraper](https://apify.com/lentic_clockss/1688-global-scraper)
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper)
- [Mercari Japan Scraper](https://apify.com/lentic_clockss/mercari-scraper)
- [ASOS Product Scraper](https://apify.com/lentic_clockss/asos-scraper)
- [Costco Product Scraper](https://apify.com/lentic_clockss/costco-scraper)
- [Cdiscount Product Scraper](https://apify.com/lentic_clockss/cdiscount-scraper)
- [E-commerce Scraper](https://apify.com/lentic_clockss/ecommerce-scraper)

#### Prefer another specialized scraper?

If your target has a specialized Actor below, use that first — usually cheaper and more structured than a generic scrape.

**Jobs & Freelance**

- [LinkedIn Jobs Scraper](https://apify.com/lentic_clockss/linkedin-jobs-scraper)
- [Indeed Jobs Scraper](https://apify.com/lentic_clockss/indeed-jobs-scraper)
- [Upwork Jobs Scraper](https://apify.com/lentic_clockss/upwork-jobs-scraper)
- [Glassdoor Scraper](https://apify.com/lentic_clockss/glassdoor-scraper)
- [Fiverr Gigs Scraper](https://apify.com/lentic_clockss/fiverr-programming-tech-gigs-scraper)
- [Bayt Jobs Scraper](https://apify.com/lentic_clockss/bayt-scraper)

**Real Estate**

- [Zillow & Zumper Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper)
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper)
- [Apartments.com Rental Scraper](https://apify.com/lentic_clockss/apartments-com-rental-scraper)
- [Rightmove Scraper](https://apify.com/lentic_clockss/rightmove-property-scraper)
- [Idealista Scraper](https://apify.com/lentic_clockss/idealista-scraper)
- [realestate.com.au Scraper](https://apify.com/lentic_clockss/realestate-com-au-scraper)

**Travel & Stays**

- [Booking.com Hotels Scraper](https://apify.com/lentic_clockss/booking-hotels-scraper)
- [Airbnb Listings Scraper](https://apify.com/lentic_clockss/airbnb-listings-scraper)
- [Expedia Scraper](https://apify.com/lentic_clockss/expedia-scraper)
- [TripAdvisor Scraper](https://apify.com/lentic_clockss/tripadvisor-scraper)

**Social & Content**

- [YouTube Research Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)
- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Shorts Scraper](https://apify.com/lentic_clockss/youtube-shorts-scraper)

**Ads Intelligence**

- [Facebook Ad Library Scraper](https://apify.com/lentic_clockss/facebook-ad-library-scraper)
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor)

**Local & Maps**

- [Google Maps Scraper](https://apify.com/lentic_clockss/google-maps-scraper)

#### General tools

- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)
- [Email Risk Validator](https://apify.com/lentic_clockss/email-risk-validator)
- [Phone Number Intelligence](https://apify.com/lentic_clockss/phone-number-intelligence)

→ See the full catalog in [Related Actors](#related-actors) below, or browse [apify.com/lentic\_clockss](https://apify.com/lentic_clockss).

***

### How to scrape Temu (no code required)

1. Create a free [Apify](https://apify.com/) account
2. Open [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
3. Choose a **mode**: `homeDiscover`, `keywordSearch`, `channelSearch`, `categorySearch`, `productDetail`, or `regions`
4. Set **region** (e.g. `us`, `uk`, `de`, `fr`, `ph`, `au`)
5. Enter a **query**, **channel**, **optId + categorySlug** (or `categoryUrl` / `bucket`), or **goodsId** / **productUrl**
6. *(Optional)* Set `sort`, `minPrice` / `maxPrice`, `enrichDetails`, `enrichLimit`, `maxResults`, `maxPages`
7. Click **Start** and download the Dataset as JSON, CSV, Excel, or JSONL

Start with `maxResults: 3–10` to verify the query, then scale up.

***

### How much does it cost to scrape Temu?

This Actor uses **pay-per-event** pricing. You are charged for:

| Event | Price |
| --- | --- |
| Actor Start (`apify-actor-start`) | **$0.005** per start |
| Result (`apify-default-dataset-item`) | **$3.00 / 1,000** results (**$0.003** each) |

**Platform usage costs are included** — you do **not** pay separate Apify compute/proxy usage for this Actor on top of the event prices above (**User pays platform usage costs = No**).

#### Example cost estimates

| Results collected | Approx. event cost\* |
| --- | ---: |
| 100 | ~$0.31 |
| 1,000 | ~$3.01 |
| 10,000 | ~$30.01 |

\*Assumes one Actor start at default memory billing for start events, plus `$0.003` per Dataset item. Exact start billing can scale with allocated memory (one start event per GB, minimum one). Default memory is **1024 MB**.

#### Free plan limits

On a **free Apify plan**, this Actor enforces developer limits of **10 runs** and **200 results per run**. Upgrade to a paid Apify plan for unlimited runs (event prices still apply).

***

### Input examples

#### Keyword search (with sort & price filter)

```json
{
  "mode": "keywordSearch",
  "region": "us",
  "query": "usb cable",
  "sort": "price_asc",
  "minPrice": 1,
  "maxPrice": 20,
  "maxResults": 40
}
```

#### Category PLP (with PDP enrich)

```json
{
  "mode": "categorySearch",
  "region": "ph",
  "categorySlug": "cables-adapters",
  "optId": "2643",
  "maxResults": 30,
  "enrichDetails": true,
  "enrichLimit": 5
}
```

#### Channel PLP

```json
{
  "mode": "channelSearch",
  "region": "de",
  "channel": "best-sellers",
  "maxResults": 40
}
```

#### Home discover

```json
{
  "mode": "homeDiscover",
  "region": "us",
  "maxResults": 40,
  "maxPages": 2
}
```

#### Product detail (PDP)

```json
{
  "mode": "productDetail",
  "region": "uk",
  "goodsId": "601100585384225"
}
```

#### Regions / channels / taxonomy

```json
{
  "mode": "regions",
  "maxResults": 200
}
```

***

### Coverage matrix

| Dimension | Coverage |
| --- | --- |
| Regions | `us`, `uk`, `de`, `fr`, `ph`, `au`, `mx`, … — 40+ `www.temu.com/{region}` codes (US bare-root entry) |
| Modes | `homeDiscover` · `keywordSearch` · `channelSearch` · `categorySearch` · `productDetail` · `regions` |
| Channels | best-sellers · full-star · new-in · lightning-deals · clearance |
| Categories | Sitemap taxonomy — ~32 verticals / 600+ `-o3-{optId}` leaves |
| Sort / filters | `default` · `sales` · `new` · `price_asc` · `price_desc` · `rating` · `minPrice`/`maxPrice` · `refine` |
| Enrich | PDP `rawData` / og tags → prices / images / mallId / description |
| Waived | Checkout · payment · auto-solving `bgn_verification` / Phantom · full review APIs |
| Identity | `goodsId` (numeric) · URL `-g-{goodsId}.html` |

***

### Output example

```json
{
  "type": "product",
  "mode": "keywordSearch",
  "region": "us",
  "goodsId": "601100585384225",
  "id": "601100585384225",
  "title": "USB Cable Fast Charge",
  "url": "https://www.temu.com/us/...-g-601100585384225.html",
  "salePrice": "3.99",
  "retailPrice": "9.99",
  "currency": "USD",
  "image": "https://img.kwcdn.com/...",
  "badges": ["Top pick"],
  "ratingValue": "4.8",
  "soldLabel": "10k+ sold",
  "scrapedAt": "2026-07-28T12:00:00+00:00"
}
```

***

### Tips for reliable runs

- Prefer **US bare root** (`region=us`) — `/us` often redirects to `bgn_no_access`
- Temu frequently shows **security verification** (`bgn_verification`); the Actor detects it and fails gracefully — it **never auto-solves** puzzles
- Prefer **`categoryUrl`** or known **`optId`** from `mode=regions` / `/v1/categories` when exploring taxonomy
- Start with small `maxResults`, then scale; enable `enrichDetails` only for the rows you need (`enrichLimit`)
- `maxPages` / scroll-feed increases browser time and event volume — keep modest for first runs
- Default Actor memory is **1024 MB** (thin client); raise only if Standby / large payloads require it

***

### Integrations

- **Apify API / Client** — start runs and fetch Dataset items programmatically
- **Schedules** — daily / hourly price and assortment monitors
- **Make / Zapier / n8n** — push rows to Sheets, Slack, webhooks, or warehouses
- **Webhooks** — notify your backend when a run succeeds

***

### Disclaimer

Temu Product Scraper is an independent, unofficial tool. Use it in accordance with applicable laws, Temu terms, and your organization’s compliance policies. The authors are not responsible for how scraped data is used.

### Related Actors

All **77** public Actors from \[[lentic\_clockss](https://apify.com/lentic_clockss)]. Click a name to open the Store detail page.

#### Jobs & Freelance

- [LinkedIn Jobs Scraper](https://apify.com/lentic_clockss/linkedin-jobs-scraper)
- [Bayt Jobs Scraper](https://apify.com/lentic_clockss/bayt-scraper)
- [Fiverr Gigs Scraper](https://apify.com/lentic_clockss/fiverr-programming-tech-gigs-scraper)
- [Freelancer.com Scraper](https://apify.com/lentic_clockss/freelancer-scraper)
- [Glassdoor Scraper](https://apify.com/lentic_clockss/glassdoor-scraper)
- [Himalayas Jobs Scraper](https://apify.com/lentic_clockss/himalayas-jobs-scraper)
- [Indeed Jobs Scraper](https://apify.com/lentic_clockss/indeed-jobs-scraper)
- [Jobicy Remote Jobs Scraper](https://apify.com/lentic_clockss/jobicy-remote-jobs-scraper)
- [RemoteOK Jobs Scraper](https://apify.com/lentic_clockss/remoteok-all-jobs-scraper)
- [SEEK Jobs Scraper](https://apify.com/lentic_clockss/seek-scraper)
- [Upwork Jobs Scraper](https://apify.com/lentic_clockss/upwork-jobs-scraper)

#### Real Estate

- [Zillow & Zumper Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper)
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper)
- [99.co Scraper](https://apify.com/lentic_clockss/ninetynine-co-sg-scraper)
- [Realtor.com Agents Scraper](https://apify.com/lentic_clockss/realtor-com-agents-scraper)
- [Apartments.com Rental Scraper](https://apify.com/lentic_clockss/apartments-com-rental-scraper)
- [Bayut Scraper](https://apify.com/lentic_clockss/bayut-uae-scraper)
- [Craigslist Housing Scraper](https://apify.com/lentic_clockss/craigslist-housing-scraper)
- [Daft.ie Scraper](https://apify.com/lentic_clockss/daft-property-scraper)
- [Dot Property Scraper](https://apify.com/lentic_clockss/dot-property-th-scraper)
- [FINN.no Scraper](https://apify.com/lentic_clockss/finn-scraper)
- [Funda Scraper](https://apify.com/lentic_clockss/funda-scraper)
- [Hepsiemlak Scraper](https://apify.com/lentic_clockss/hepsiemlak-scraper)
- [Idealista Scraper](https://apify.com/lentic_clockss/idealista-scraper)
- [Immobiliare.it Scraper](https://apify.com/lentic_clockss/immobiliare-property-scraper)
- [ImmoScout24 Scraper](https://apify.com/lentic_clockss/immobilienscout24-scraper)
- [Naver Land Scraper](https://apify.com/lentic_clockss/naver-land-scraper)
- [OpenSooq Scraper](https://apify.com/lentic_clockss/opensooq-real-estate-scraper)
- [Otodom Scraper](https://apify.com/lentic_clockss/otodom-scraper)
- [Property Finder Scraper](https://apify.com/lentic_clockss/property-finder-uae-scraper)
- [PropertyGuru Scraper](https://apify.com/lentic_clockss/propertyguru-sg-scraper)
- [realestate.com.au Scraper](https://apify.com/lentic_clockss/realestate-com-au-scraper)
- [Realtor.ca Scraper](https://apify.com/lentic_clockss/realtor-ca-scraper)
- [Rightmove Scraper](https://apify.com/lentic_clockss/rightmove-property-scraper)
- [SeLoger Scraper](https://apify.com/lentic_clockss/seloger-property-scraper)
- [SUUMO Scraper](https://apify.com/lentic_clockss/suumo-property-scraper)
- [Zillow Group Scraper](https://apify.com/lentic_clockss/zillow-group-scraper)

#### E-commerce

- [Shopee Search Scraper](https://apify.com/lentic_clockss/shopee-search-scraper)
- [E-commerce Scraper](https://apify.com/lentic_clockss/ecommerce-scraper)
- [1688 Global Product Search Scraper](https://apify.com/lentic_clockss/1688-global-scraper)
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper)
- [Amazon Search Scraper](https://apify.com/lentic_clockss/amazon-search-results-collector)
- [ASOS Product Scraper](https://apify.com/lentic_clockss/asos-scraper)
- [Cdiscount Product Scraper](https://apify.com/lentic_clockss/cdiscount-scraper)
- [Costco Product Scraper](https://apify.com/lentic_clockss/costco-scraper)
- [Coupang Product Scraper](https://apify.com/lentic_clockss/coupang-scraper)
- [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
- [Lazada Scraper](https://apify.com/lentic_clockss/lazada-ph-search-results-collector)
- [MercadoLibre Scraper](https://apify.com/lentic_clockss/mercadolibre-scraper)
- [Mercari Japan Scraper](https://apify.com/lentic_clockss/mercari-scraper)
- [Rakuten Japan Scraper](https://apify.com/lentic_clockss/rakuten-scraper)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)
- [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)

#### Travel & Stays

- [Booking.com & Airbnb Scraper](https://apify.com/lentic_clockss/booking-airbnb-scraper)
- [Agoda Scraper](https://apify.com/lentic_clockss/agoda-scraper)
- [Airbnb Listings Scraper](https://apify.com/lentic_clockss/airbnb-listings-scraper)
- [Booking.com Hotels Scraper](https://apify.com/lentic_clockss/booking-hotels-scraper)
- [Despegar Scraper](https://apify.com/lentic_clockss/despegar-scraper)
- [Expedia Scraper](https://apify.com/lentic_clockss/expedia-scraper)
- [Traveloka Scraper](https://apify.com/lentic_clockss/traveloka-scraper)
- [Travelstart Flights Scraper](https://apify.com/lentic_clockss/travelstart-scraper)
- [Trip.com Scraper](https://apify.com/lentic_clockss/trip-com-scraper)
- [TripAdvisor Scraper](https://apify.com/lentic_clockss/tripadvisor-scraper)

#### Social & Content

- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Shorts Scraper](https://apify.com/lentic_clockss/youtube-shorts-scraper)
- [YouTube Research Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)
- [Hacker News Scraper](https://apify.com/lentic_clockss/hacker-news-scraper)

#### Ads Intelligence

- [Facebook Ad Library Scraper](https://apify.com/lentic_clockss/facebook-ad-library-scraper)
- [Google Ads Transparency VN](https://apify.com/lentic_clockss/google-ads-transparency-center-vn)
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor)

#### Local & Maps

- [Google Maps Scraper](https://apify.com/lentic_clockss/google-maps-scraper)

#### General Tools

- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)
- [Email Risk Validator](https://apify.com/lentic_clockss/email-risk-validator)
- [Phone Number Intelligence](https://apify.com/lentic_clockss/phone-number-intelligence)

→ Browse the full profile: [apify.com/lentic\_clockss](https://apify.com/lentic_clockss)

# Actor input Schema

## `mode` (type: `string`):

homeDiscover / keywordSearch / channelSearch / categorySearch / productDetail / regions.

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

Temu path prefix: us, uk, de, fr, au, ph, … US often uses bare www root.

## `browseCountry` (type: `string`):

Optional ISO-2 alias (US→us, GB→uk, PH→ph).

## `currency` (type: `string`):

Optional currency override (e.g. USD, PHP, EUR).

## `query` (type: `string`):

Keyword for keywordSearch.

## `keyword` (type: `string`):

Alias of query.

## `keywords` (type: `array`):

Optional list of keywords.

## `channel` (type: `string`):

best-sellers / full-star / new-in / lightning-deals / clearance.

## `categorySlug` (type: `string`):

Temu -o3- slug (e.g. cables-adapters).

## `optId` (type: `string`):

Temu sitemap optId (e.g. 2643 for cables-adapters).

## `catId` (type: `string`):

Alias of optId.

## `categoryUrl` (type: `string`):

Full or path category URL containing -o3-{optId}.html.

## `bucket` (type: `string`):

Vertical id/bucket for categorySearch or regions filter.

## `productUrl` (type: `string`):

PDP URL containing -g-{goodsId}.html.

## `goodsId` (type: `string`):

Numeric Temu goodsId.

## `page` (type: `integer`):

1-based page for search/channel/category.

## `maxResults` (type: `integer`):

Cap on dataset rows. Free plan capped at 200.

## `maxPages` (type: `integer`):

Pagination / scroll-feed rounds (home feed + list page=).

## `sort` (type: `string`):

default|sales|new|price\_asc|price\_desc|rating (best-effort query params).

## `minPrice` (type: `number`):

Optional min\_price filter.

## `maxPrice` (type: `number`):

Optional max\_price filter.

## `refine` (type: `string`):

Opaque filter string when known.

## `enrichDetails` (type: `boolean`):

For listing modes, fetch PDP for enrichLimit items (contract fields when available).

## `enrichLimit` (type: `integer`):

Max listing rows to enrich with PDP.

## `pageRetry` (type: `integer`):

Retries when verification/empty (new browser session).

## `browserCountryPin` (type: `string`):

Optional TEMU\_BROWSER\_COUNTRY\_PIN override: off|auto|xx. Default worker env is off.

## `workerBaseUrl` (type: `string`):

Optional HTTPS Cloud Run origin (allowlisted).

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

Unused when WORKER\_PROVIDES\_PROXY=1 (default).

## Actor input object example

```json
{
  "mode": "homeDiscover",
  "region": "us",
  "page": 1,
  "maxResults": 40,
  "maxPages": 1,
  "enrichDetails": false,
  "enrichLimit": 3,
  "pageRetry": 2
}
```

# Actor output Schema

## `results` (type: `string`):

Normalized Walmart product / category rows from the default dataset.

## `runSummary` (type: `string`):

Structured summary record stored in the default key-value store.

## `inputEcho` (type: `string`):

Normalized input saved at run start.

## `errorSummary` (type: `string`):

Present when a failed run stores structured terminal error information.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("lentic_clockss/temu-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 = {}

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

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

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

```

## CLI example

```bash
echo '{}' |
apify call lentic_clockss/temu-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=lentic_clockss/temu-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/jOR2L8EOlrBXW75RG/builds/vjIrhRywZgbYfh7NB/openapi.json