TikTok Shop & E-Commerce Sales Velocity Tracker

This Actor reads public TikTok Shop or Shein category/product pages and ranks products only when the page exposes sales telemetry. It persists a bounded per-category history so cumulative unit counters can produce a real snapshot delta on later runs. It does not infer sales from popularity badges, solve CAPTCHAs, or call private seller APIs.

Input

{
  "category": "Beauty & Personal Care",
  "minDailySales": 50,
  "sortBy": "SALES_VELOCITY",
  "maxProducts": 500,
  "maxRetries": 2,
  "proxyConfiguration": { "useApifyProxy": true }
}

Optional platform: "shein" and startUrls allow a public Shein category or a region-specific source URL. TikTok categories use the current public /us/k/<keyword> storefront route. Public-site markup and anti-bot behavior can change; proxy retries rotate bounded sessions and user agents, challenge pages are detected but never solved or bypassed, and empty product pages are recorded as bounded source warnings in RUN_SUMMARY. If every request remains blocked, the run fails clearly instead of succeeding with an unexplained empty dataset.

Output

Each item contains productId, title, productUrl, price, currency, commissionRate, totalUnitsSold, totalUnitsSoldSource, salesLast24h, velocitySource, snapshot timing, estDailyRevenue, affiliateCreatorCount, top affiliate handles, and a quality score. Exact embedded product counters are preferred over rounded visible labels, and the selected evidence is identified as embedded_public_page or visible_page_text. Unknown values are null, not zero. Revenue is calculated only when price currency is known; the USD alias is populated only for USD.

When a source reports a true 24-hour field, velocitySource is source_reported_24h. Otherwise, the first run stores a snapshot and immediately returns the strongest cumulative-sales baselines as uncharged records with salesLast24h: null; a later run 1–168 hours afterward can report snapshot_delta. Counter resets and stale histories remain null and are labeled explicitly.

Resource controls

• Pages are fetched sequentially with streamed byte limits and timeouts.
• A bounded, update-aware min-heap retains only the requested top-K products.
• Snapshot history uses one bounded key-value record per platform/category scope, capped at 5,000 products.
• Products are emitted after ranking; raw page objects are not retained.
• Page discovery and affiliate-handle lists are capped.

Monetization

The manifest declares product-record at $0.003 per usable velocity record ($3.00 per 1,000). Products without source-reported or valid snapshot-derived velocity are not charged. A $39/month rental offer can be configured separately in the Apify Store listing.

The published schema includes a one-page, ten-product TikTok Shop prefill for the Store health test. First observations with cumulative sales but no defensible 24-hour delta are returned as uncharged baselines; rerun later to derive snapshot velocity.

Local development

npm install
npm test
npm run check
apify validate-schema .actor/input_schema.json
apify run --purge