Trending TikTok Shop products as a ready-to-use feed: each product with its driving video, price + sale price, 'X sold', rank, and (on scheduled runs) sales velocity + price history. From public Creative Center Top Products + product pages - no seller account, no Shop API. PPE pricing.
Initial build. A public-data trending-TikTok-Shop-products feed (product + driving
video + price/sales) for sites like thedailyvirals.com. No seller account, no
TikTok Shop Open API, no USDS review.
Surfaces: Creative Center Top Products (browser tier captures the page's own
product-list XHR), public TikTok Shop product page (price / sale price / "X sold"
/ rating enrichment), public video page (driving-video engagement).
Modes:feed (full record) and discover (leaderboard only).
Velocity / price history: on scheduled runs, diffs against the prior snapshot
and emits units_sold_per_day, price_change, rank_change, is_new, plus a
movers digest (fastest-selling / biggest-climbers / new-entrants) with optional
Slack webhook. Snapshots from the first run so history accrues forward.
Monetization:affiliate_tag appended to every buy_url.
Reuses the proven tiktok-research-intel browser tier, escalation ladder, and
monitor-mode state store.
Validation: 63/63 offline smoke checks (scripts/smoke_test_tiktok_trending.py)
on real-shaped fixtures; all modules compile; all .actor JSON valid. The live
browser-tier extraction is confirmed on the first deployed run (playwright image).
Known follow-ups
Confirm/tune the Creative Center creative_radar product-list endpoint needle on
the first live browser run.
Richer driving-video stats via an optional video-page fetch (currently sourced from
Creative Center's linked refs).
related_actors.py cross-promo registration for this slug.
Region/category deep-filtering on the Creative Center page (currently region +
period via page params; category is best-effort).