# TikTok Shop Product Scraper | Prices Sold Global (`lentic_clockss/tiktok-shop-scraper`) Actor

Scrape TikTok Shop products — keyword, category, home discover & PDP across US/UK/Asia regions. Extract productId, prices, ratings, sold counts & shop info. Export Excel/CSV/JSON for research & price monitoring.

- **URL**: https://apify.com/lentic\_clockss/tiktok-shop-scraper.md
- **Developed by:** [kane liu](https://apify.com/lentic_clockss) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 1 total users, 0 monthly users, 100.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

## TikTok Shop Product Scraper | Prices Sold Global

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

Use this Actor as a practical **TikTok Shop product scraper / data API** for marketplace research, price monitoring, assortment tracking, and competitor analysis on [shop.tiktok.com](https://shop.tiktok.com/) (`shop.tiktok.com/{region}` for US, UK, PH, ID, MY, TH, VN, SG, and more).

Built for sellers, dropshippers, agencies, and analysts who need clean **productId, title, sale/origin price, currency, images, rating, sold count, and shop** fields without building a custom browser stack.

### Features

- **Category PLP** — scrape `/c/{slug}/{categoryId}` listings with load-more pagination
- **Keyword search (UI)** — submit mall search and collect product cards
- **Mall home discover** — pull home/discover product surfaces by region
- **Product PDP** — fetch detail pages by `productId` or product URL
- **Regional storefronts** — path prefix `{region}` (ph, us, gb, id, my, th, vn, sg, …)
- **Optional PDP enrich** — `enrichDetails` adds SKUs, gallery, shop/review summaries for listing rows
- **Structured export** — Excel / CSV / JSON; connect Make, n8n, Zapier, Python, or the Apify API
- **Thin Actor + Cloud Run worker** — residential egress owned by the worker (`WORKER_PROVIDES_PROXY=1`)

> **Unofficial tool.** Not affiliated with TikTok. Collects publicly reachable product surfaces. Does **not** log in, checkout, or auto-solve Security Check / captcha.

### What you can scrape

| Mode | What you get | Typical inputs |
| --- | --- | --- |
| `keywordSearch` | Search result product cards | `query` + `region` |
| `categorySearch` | Category listing products | `categoryId` + `categorySlug` (or `categoryUrl` / seed `bucket`) |
| `homeDiscover` | Mall home / discover products | `region` |
| `productDetail` | Full PDP fields | `productId` or `productUrl` |
| `categoryDiscover` | Live category tree discover | `region` |
| `regions` | Region + taxonomy seed rows | — |

**Core fields (listings):** productId, title, sale price, origin price, currency, images, rating, sold count, shop name, region, source URL.

**PDP enrich (optional):** SKUs / variants, image gallery, shop summary, review summary when the page exposes them.

### Why this Actor

Competing TikTok Shop scrapers often focus on creators, GMV estimates, or single-market search. This Actor is built for **product catalog coverage across regional storefronts** — keyword + category + home + PDP — with a clear free-tier cap and pay-per-result pricing.

| Need | This Actor |
| --- | --- |
| Multi-region `shop.tiktok.com/{region}` | Yes |
| Keyword + category + PDP in one tool | Yes |
| Creator / affiliate GMV dashboards | Use a dedicated creators Actor |
| Login, checkout, or captcha solving | Out of scope |

### Free tier

| Cap | Free Apify plan |
| --- | --- |
| Runs of this Actor | **10** total |
| Results per run | **200** |

Paying Apify users: unlimited runs (schema max still applies). Limits are enforced by this Actor's code (not Apify Console).

### Coverage matrix

| Dimension | Scope |
| --- | --- |
| Regions | `shop.tiktok.com/{region}` — open 2–6 letter codes (us, gb, ph, id, my, th, vn, sg, …) |
| Categories | Mall taxonomy + `/c/{slug}/{id}` |
| Services | homeDiscover, keywordSearch (UI), categorySearch, categoryDiscover, productDetail, regions |
| Waived | Checkout / login; standalone seller CRM; auto captcha solve |

### Pricing

**Pay per event.** You pay for Actor start + each **result** written to the default dataset. Platform compute usage for this Actor is paid by the developer (`User pays platform usage costs = No`).

| Event | Price |
| --- | --- |
| Actor Start (`apify-actor-start`) | **$0.005** per start (per GB memory, min 1) |
| result (`apify-default-dataset-item`) | **$3.00 / 1,000** on FREE & BRONZE (see tiers) |

| Apify Store tier | $/1,000 results | per result |
| --- | --- | --- |
| FREE\* | $3.00 | $0.003 |
| BRONZE | $3.00 | $0.003 |
| SILVER | $2.60 | $0.0026 |
| GOLD | $2.20 | $0.0022 |
| PLATINUM | $2.00 | $0.002 |
| DIAMOND | $1.60 | $0.0016 |

\*Free-plan run/result caps above still apply.

### More Actors like this

Looking for other marketplace or TikTok tools? Prefer a **dedicated site Actor** when one exists — structured fields, better coverage, usually lower cost. Use [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper) only for generic protected URLs.

#### Same ecosystem (TikTok)

- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper) — videos / profiles / content
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor) — Creative Center + Ads Library

#### E-commerce (prefer these for other stores)

- [Shopee Search Scraper](https://apify.com/lentic_clockss/shopee-search-scraper)
- [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)
- [Amazon Search Scraper](https://apify.com/lentic_clockss/amazon-search-results-collector)
- [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper)
- [Lazada Scraper](https://apify.com/lentic_clockss/lazada-ph-search-results-collector)
- [MercadoLibre Scraper](https://apify.com/lentic_clockss/mercadolibre-scraper)
- [Rakuten Japan Scraper](https://apify.com/lentic_clockss/rakuten-scraper)
- [Mercari Japan Scraper](https://apify.com/lentic_clockss/mercari-scraper)

#### Prefer a dedicated site scraper?

**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)
- [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)

**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 use (no code required)

1. Click **Try for free** (or **Start**) on this Actor page
2. Pick a **mode** (`keywordSearch`, `categorySearch`, `homeDiscover`, or `productDetail`)
3. Set **region** (e.g. `us`, `gb`, `ph`)
4. Fill mode inputs (`query`, `categoryId` + `categorySlug`, or `productId` / URL)
5. Keep `maxResults` small for tests (e.g. 20–40)
6. Click **Start** — rows appear in the **Dataset** tab
7. Download **Excel / CSV / JSON**, or pull via the Dataset API

#### Example inputs

**Keyword search (US):**

```json
{
  "mode": "keywordSearch",
  "region": "us",
  "query": "usb cable",
  "maxResults": 40
}
```

**Category PLP (PH beauty):**

```json
{
  "mode": "categorySearch",
  "region": "ph",
  "categorySlug": "beauty-personal-care",
  "categoryId": "601450",
  "maxResults": 40,
  "maxPages": 2
}
```

**Product detail:**

```json
{
  "mode": "productDetail",
  "region": "us",
  "productUrl": "https://shop.tiktok.com/us/pdp/example-slug/1234567890"
}
```

### What you get back

Successful rows go to the default dataset. Typical listing fields:

| Field | Description |
| --- | --- |
| `productId` | TikTok Shop product id |
| `title` | Product title |
| `salePrice` / `originPrice` | Price fields when present |
| `currency` | Currency code / symbol |
| `rating` / `soldCount` | Social proof metrics |
| `shopName` | Seller / shop display name |
| `images` | Image URLs |
| `region` | Storefront region code |
| `url` | Product or listing URL |
| `source` / diagnostics | Mode and scrape metadata when enabled |

Enable `enrichDetails` (+ `enrichLimit`) to attach PDP-level extras for a subset of listing rows.

### Connect to your tools

| Platform | How to connect |
| --- | --- |
| **Make.com** | Search "Apify" → Run Actor → `lentic_clockss/tiktok-shop-scraper` |
| **n8n** | Apify node → Run Actor → same Actor ID |
| **Zapier** | Apify → Run Actor |
| **Python / Node.js** | Apify client SDK or HTTPS API |

```bash
curl "https://api.apify.com/v2/acts/lentic_clockss~tiktok-shop-scraper/runs" \
  -X POST \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"keywordSearch","region":"us","query":"skincare","maxResults":20}'
```

```http
GET https://api.apify.com/v2/datasets/{datasetId}/items?format=json
```

### Architecture

Thin Apify Actor → HTTPS Cloud Run worker (`tiktok-shop-com`) → shop.tiktok.com (Remix `loaderData`).

Required env (already set on the Actor): `WORKER_BASE_URL`, `WORKER_AUTH`, `WORKER_PROVIDES_PROXY=1`.

Standby / Live View OpenAPI is shipped via `.actor/openapi.json` for interactive checks; persist production jobs as normal Actor runs.

### FAQ

**Q: Which countries / regions work?**\
A: Any open `shop.tiktok.com/{region}` path the mall exposes (us, gb, ph, id, my, th, vn, sg, …). Availability follows TikTok’s storefronts.

**Q: Do I need my own proxies?**\
A: No for normal runs. The Cloud Run worker provides residential egress.

**Q: Will this solve Security Check / captcha?**\
A: No. Captcha / Security Check is never auto-solved. Retry later or adjust region / volume.

**Q: Is this official TikTok API access?**\
A: No. Unofficial public-page extraction. Not affiliated with TikTok.

**Q: How is billing calculated?**\
A: Actor Start + each default-dataset **result**. See the Pricing table and Store tier discounts.

### Input reference

| Parameter | Type | Description |
| --- | --- | --- |
| `mode` | string | `homeDiscover` / `keywordSearch` / `categorySearch` / `categoryDiscover` / `productDetail` / `regions` |
| `region` | string | Path prefix: `ph`, `us`, `gb`, `id`, … |
| `query` / `keyword` | string | Keyword for `keywordSearch` |
| `categorySlug` + `categoryId` | string | Category PLP identifiers |
| `categoryUrl` | string | Full category URL shortcut |
| `productId` / `productUrl` | string | PDP target |
| `maxResults` | integer | Cap dataset rows (free plan ≤ 200) |
| `maxPages` | integer | Category load-more rounds |
| `enrichDetails` | boolean | Enrich listings via PDP |
| `enrichLimit` | integer | Max rows to enrich |
| `proxyConfiguration` | object | Usually unused — worker owns egress |

Full schemas: Input / Dataset tabs in Console.

***

### 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 / categorySearch / categoryDiscover / productDetail / regions.

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

shop.tiktok.com/{region} path prefix: ph, us, gb, id, my, th, vn, sg, …

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

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

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

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

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

Keyword for keywordSearch (submitted via mall search box).

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

Alias of query.

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

Optional list of keywords.

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

URL slug, e.g. beauty-personal-care or makeup.

## `categoryId` (type: `string`):

Numeric category id from /c/{slug}/{categoryId} (e.g. 601450).

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

Alias of categoryId.

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

Full category URL https://shop.tiktok.com/{region}/c/{slug}/{id}.

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

Optional seed taxonomy bucket (beauty, fashion, electronics, …).

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

Full PDP URL containing /pdp/{slug}/{productId}.

## `productId` (type: `string`):

Numeric product id for productDetail.

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

Alias of productId.

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

Maximum dataset rows. Free plan capped at 200.

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

Category load-more clicks (hasMore). Not ?page=N.

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

Fetch PDP details for the first enrichLimit listing rows.

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

Max listing rows to enrich via PDP when enrichDetails is true.

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

Retries per page/request on transient failures.

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

Optional HTTPS Cloud Run override (allowlisted hosts only).

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

Usually unused — worker owns egress (WORKER\_PROVIDES\_PROXY=1).

## Actor input object example

```json
{
  "mode": "categorySearch",
  "region": "ph",
  "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/tiktok-shop-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/tiktok-shop-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/tiktok-shop-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Oux9i878cjkckvxMA/builds/8DEfroXZZ2ZZDxw0G/openapi.json