# Changelog of TikTok Shop Scraper | Products, Prices & Best Sellers (`apivault_labs/tiktok-shop-scraper`) Actor

- **URL**: https://apify.com/apivault\_labs/tiktok-shop-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/apivault\_labs/tiktok-shop-scraper.md

## Changelog

All notable changes to this Actor will be documented here.

### \[2.6] — 2026-08-07

#### Fixed

- Removed a duplicate "All Fields" tab — the platform already provides a
  built-in "All fields" view, so now there's just one.

### \[2.5] — 2026-08-07

#### Added — one-click views (pick the data you care about)

- The dataset now opens with ready-made tabs so you don't scroll through every
  column: **🔥 Winning Products**, **💰 Dropshipping Profit**,
  **🏢 Suppliers & Leads**, **📈 Sales Velocity**, **📦 Shipping & Variants**,
  and **📋 All Fields**. Switch tab to instantly filter to the fields for that job.
- Profit metrics (`landedCost`, `suggestedResale`, `profitPerUnit`,
  `grossMarginPercent`) are now top-level columns for easy sorting/filtering.

### \[2.4] — 2026-08-07

#### Added — live sales velocity (the #1 winning-product signal)

- **`salesVelocityPerDay`, `revenueVelocityPerDay`, `momentum`** — the actor now
  remembers each product's sold count between runs and reports how fast it is
  selling RIGHT NOW, not just lifetime totals. The first run records a baseline;
  run the same product again later (e.g. daily) to get units/day, revenue/day
  and a momentum tier (surging / hot / steady / slow). Also
  `salesSinceLastCheck` and `daysSinceLastCheck`. Computed automatically by
  comparing runs — no extra input needed. Toggle with `trackSalesVelocity`.

### \[2.3] — 2026-08-07

#### Added — data no other TikTok Shop scraper gives

- **Supplier identity**: `businessName` + `businessAddress` — the legal seller
  entity and address behind the shop (turns product research into supplier
  sourcing / lead generation). Plus `legitWarnings` compliance flags.
- **Logistics for sourcing**: `logistics` block with delivery time
  (`deliveryMinDays`/`deliveryMaxDays`), `codAvailable`, real package
  `packageWeight` + `packageDimensions`, and `shippingFee`.
- **Variant options**: `saleProperties` (e.g. Size, Color) with their values.
- **Availability** flag.
- **Dropshipping profit & viability**: `profit` (landed cost, suggested resale,
  profit per unit, gross-margin %) plus `dropshipViable` + `dropshipSignals` —
  the "should I sell this?" answer computed from the real price + package weight
  - shipping.

### \[2.2] — 2026-08-07

#### Changed — faster & lower cost

- Reworked the fetching engine for higher reliability and much lower running
  cost, with no change to the data you get. Runs are faster and cheaper.

### \[2.1] — 2026-07-14

#### Added — exact price, GMV & trending mode

- **Exact, unmasked price** (`price`, `originalPrice`) — resolves the price that
  is masked on logged-out product pages.
- **GMV / revenue estimate** (`gmvEstimate`) — exact price × total units sold,
  an approximate lifetime revenue for competitive research.
- **Trending / best-sellers mode** (`trending: true`) — scrape TikTok Shop's live
  ranking of top viral products (rank, exact price, units sold, rating, seller,
  GMV estimate, hot-product score) without needing any product URL.
- New `exactPrice` option (default on). Falls back to `priceMasked: true`
  gracefully if a price can't be resolved for a product.

### \[2.0] — 2026-06-07

#### Changed — faster, more reliable engine

- Rewritten to fetch TikTok Shop product data directly with no third-party
  backend, for higher reliability and lower cost.
- Robust parsing of TikTok's deeply-nested product data.

#### Added

- Rich fields: **variants/SKUs with real stock**, weight & dimensions, total
  stock, images gallery, specifications, rating, review count, sold count,
  seller info, shipping (free-shipping flag, fee, delivery name), discount %.
- **Hot-product score (0-100)** + tier + reasons — dropshipping signal no
  competing TikTok Shop actor offers.
- Accepts product URLs or bare numeric IDs; per-product retry with fresh IP.

#### Known limitation

- TikTok **masks the exact price digits** on logged-out product pages, so
  product mode returns discount %, currency and a masked indicator. The exact
  price is available from search/category endpoints (planned Search mode).

### \[1.0] — 2026-06-03

#### Changed

- README pricing corrected to **$0.003 per product** ($3 per 1,000) to match
  the actual charge (README previously showed an outdated $1/1K).

#### Added

- Real-time TikTok Shop product scraping — prices, discounts, ratings, sales
  count, shop info, image
- Configurable field selection
- No login or API key required