# Changelog of TikTok Shop Product API — Sales, Revenue & Creators (`blueskyscraper/tiktok-shop-product-api`) Actor

- **URL**: https://apify.com/blueskyscraper/tiktok-shop-product-api/changelog.md
- **Full Actor documentation**: https://apify.com/blueskyscraper/tiktok-shop-product-api.md

## Changelog

### 2026-10-30

- Apify Free plan: a product page TikTok Shop answers with a security check now comes back as a note that any paid plan opens it through our unblocking service, instead of an error.
- Apify Free plan: a hidden product past the one free row now comes back as a note to upgrade to a paid plan, also when the storefront page opens without the product.
- Products the storefront hides (refused in every region, or served to a logged-out visitor without the product block) are now looked up together, up to 100 per request, in a second sales-analytics source first: units sold and revenue for 7, 28 and 90 days, creators, videos, commission. Such rows have no video / live / shop revenue split; the previous source is still asked for anything the first one does not know.
- Fixed: products found by a search could come back as bare list cards without description, specifications and images. A cheaper proxy route answered "not available in your region", and the Actor took that as final although the product page opens through the last unblocking step. Now only the last route's answer is final.

### 2026-10-22

- Maintenance: the last-resort unblocking step updated to the current shared version (retries without a country header when a site rejects it).

### 2026-10-21

- Maintenance: run-end alerts updated to the current shared version; a run stopped by "Max cost per run" always ends with a status message telling you so.

### 0.5.1 — 2026-10-16

- Rows in TikTok's own order now come out in rank order with positions 1, 2, 3… (they used to follow whichever product page loaded first).
- A keyword with no letters or digits gives a free notice instead of random paid products; the same keyword or link twice is read once.
- Notices and error rows are written after the products.
- 7-day sales use a full 7-day window when the history has one and never exceed lifetime units sold.

### 0.5 — 2026-10-08

- Full reviews for TikTok Shop UK products too (through a UK residential address).

### 0.4.1 — 2026-10-08

- Review rows now $1 per 1,000 ($0.70 on Gold and above), down from $2.

### 0.4 — 2026-10-07

- Full product reviews (US): one row per review with stars, text, date, photos, variant, verified-purchase flag and reviewer; newest or recommended order; star, photo and verified filters; up to 25,000 per product. $2 per 1,000 reviews.

### 0.3 — 2026-10-07

- Southeast Asia: Thailand, Malaysia, Singapore, Philippines, Vietnam (category, store and product links).

### 0.2 — 2026-10-07

- Shared daily sales history: sold7d, sold30d, revenue7d, revenue30d, salesHistory, trackedSince from the first run for tracked products.
- Sort by units sold, revenue, 7/30-day sales, rating or price (reads deeper, rows in rank order).

### 0.1 — 2026-10-07 (price $4 per 1,000 rows)

- First version: TikTok Shop products from keyword search (with paging and related-search widening), categories, best-seller ranking, stores and product links (US; UK via category, store and product links).
- Product-page details: variants with stock, rating breakdown, description, specifications, shipping, category path, latest reviews, shop stats.
- Creators promoting each product: promo videos with views, likes and commission flag; handle, followers and bio from TikTok.
- Sales tracking between runs: soldSinceLastCheck, dailySalesEstimate, revenueSinceLastCheck.
- Filters: minimum units sold, price range, minimum rating — filtered products are free.