# Changelog of TikTok Shop Product & Trend Tracker — Authorized Feed (MVP) (`optirefine/tiktok-shop-trend-tracker`) Actor

- **URL**: https://apify.com/optirefine/tiktok-shop-trend-tracker/changelog.md
- **Full Actor documentation**: https://apify.com/optirefine/tiktok-shop-trend-tracker.md

### 0.3.1 — Stale-build diagnostics and source contract hardening (2026-10-29)

- Confirmed the v0.3.x input parser, routing and SandBase adapter are included in the complete project. The latest reported cloud run is from an older v0.2.0 image, so the cloud fix requires deploying and selecting the new build.
- Added an unmistakable startup marker `OPTIREFINE TRACKER RELEASE 0.3.1 | SandBase runtime enabled` and consistent `RUN_SUMMARY.actorVersion`.
- Added deployment-contract regression tests covering schema-to-runtime parity and the SandBase call path.
- Map SandBase's published `seo_url.canonical_url` to the normalized product URL when available.
- Added an explicit existing-Actor deployment guide to protect the v0.2 rollback.
- No live provider extraction or Apify deployment claimed.

### 0.3.0 — SandBase source adapter (private pilot)

- Accepts `sandbase` in schema AND runtime.
- Calls the documented SandBase TikTok Shop Product Search V2 endpoint, one page per keyword.
- Limits SandBase API requests per run; no automatic retries/pagination to constrain free-tier consumption.
- Validates product fields conservatively, records missing fields as null, and preserves history/diff logic.
- Keeps OpenClawAI, authorized datasets and synthetic local fixtures.
- Live SandBase response mapping not verified against an authenticated V2 response; test privately.
- Do not publish paid redistributions without verifying provider/TikTok permissions.

## Changelog

### 0.2.0 — 2026-10-28

- Add third-party Apify Actor product keyword search and product-ID lookup as a permission-gated external source.
- Add a hard per-upstream-run charge limit and normalized product-only mapping.
- Add input source selection, keyword fields, repeat-monitoring examples, and explicit reuse permissions.
- Fix dataset resource picker READ permissions for limited-permission Actors and Docker TypeScript installation.
- Add offline integration/mapping tests; no live cloud deployment claimed.

### 0.1.0 — 2026-10-28

- Initial authorized dataset import, product snapshots, history diffs, and conservative trend model.