Read the competitor watch
list_watch_findingsRetrieve competitor watch findings: new ads each watched brand launched since the last check, plus watch state and run status. Read-only and free—returns stored results without triggering a new check.
Instructions
Read what the standing COMPETITOR WATCH has found — the new ads each watched brand has launched since the last check, plus the watch's own state (who is watched, when it last ran, when it runs next, and whether the last run actually succeeded). The same board the web app's Ad Spy ▸ Watching tab renders. Use it to answer "what are our competitors running that's new?", to feed a teardown, or to save something worth keeping with save_to_swipefile. Findings marked seed:true are NOT new launches — the first check of a brand has nothing to diff against, so it seeds the board with what that brand is running right now; only later runs surface genuine changes. Read-only and free — it returns the stored results of past runs and never triggers a check (set_competitor_watch({runNow:true}) is what runs one).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | max findings to return (default 25, max 75 — the server keeps at most 75, and at most 15 per brand) | |
| competitor | No | only findings for this watched brand (exact name as returned in `watching`) — omit for all of them |