# Changelog of TikTok Ad Intelligence & Creative Watcher (`marielise.dev/tiktok-creative-watch`) Actor

- **URL**: https://apify.com/marielise.dev/tiktok-creative-watch/changelog.md
- **Full Actor documentation**: https://apify.com/marielise.dev/tiktok-creative-watch.md

## Changelog

### 0.3

- Made the Actor callable by an AI agent. `countries` and `period` replace hand-built Creative Center URLs as the primary input, no field is required, and every field has a default, so a call with an empty input object returns useful data instead of a validation error. `searchUrls` remains supported for industry filters and saved tasks.
- Flattened the dataset record and led it with `status`. Media and source URLs, identifiers and the opportunity score are now top level; watch fingerprints are no longer emitted.
- A market that returns nothing now produces a `no_results` record naming the market and the reason, instead of silently emitting nothing. Added a `Sources that returned nothing` dataset view.
- Added a real dataset schema, Store categories, and MCP setup instructions covering the hosted Apify MCP server and the direct API.
- Turned Standby mode off. The API rejects Standby Actors from agentic payments (`actor-standby-not-supported-for-agentic-payments`) and this Actor is currently whitelisted for them; `mcp.apify.com` builds its tool from the input schema and starts a normal run, so a Standby MCP endpoint added no discovery benefit. `src/mcp.ts` is retained but dormant.
- Repriced against measured platform cost. A run-start charge of $0.10 returns so that no run can produce zero revenue, `source-monitored` is registered at $0.20 as the primary event, and per-creative and AI-insight prices are cut to $0.004 and $0.010.
- The remaining budget is now checked **before** a market is fetched. Previously the proxy bandwidth for a source was spent and only then found to be unbillable.
- A run now stops after two consecutive markets return nothing, instead of spending the whole budget against a target that is refusing it.

### 0.2

- Repriced. The run-start charge is removed, a `source-monitored` event replaces per-creative billing as the primary line, and per-creative and AI-insight prices are cut. A small watch run now costs about $0.066 instead of $0.372.
- AI creative analysis is off by default, and is never charged for an unchanged creative.
- Added an MCP server. The Actor runs in Standby mode and exposes tools at `/mcp` for AI agents.
- Fixed a charging guard that stopped every non-pay-per-event run, including all local runs, after the first result.
- Fixed watch-state data loss. Ads truncated by a spending limit are no longer marked as seen.
- Corrected the market-selection documentation. TikTok honours the market selector on the Creative Center URL; it is not resolved solely from the requesting IP address.
- Pinned memory so the advertised start price cannot change with the memory setting.
- Removed invalid keys from `.actor/actor.json`.