Watchlist & growth alerts — monitor creators and catch them rising

What it is

The watchlist is a change digest, not a bookmarks folder. Watched creators get scheduled stat snapshots; GET /api/watchlist returns entries ranked by a 0–100 significance score — whoever changed most meaningfully this week floats to the top, and a quiet week reads in 30 seconds. The watchlist runs on its own schedule whether or not you log in.

What each digest entry shows

• Current stats: followers, average views, engagement rate, authenticity score.
• Two windows: 7d and 30d deltas for followers (absolute + %), average views and engagement rate, plus how many snapshots back the window — your freshness guarantee.
• Signal badges: rising · dormant · trending-video · sponsored · contact-updated · outreach-event.
• Recent activity events and a cached AI activity summary (what they've been posting over 7/30/90 days).

The digest header rolls everything up: how many watched, how many rising, how many dormant, trending videos and recent contact changes — the Monday-morning answer in one line.

Growth alerts

Alerts arrive on the Alerts page (GET /api/alerts, filter by type or unread). Thresholds are yours to tune via alert preferences — lookback days, minimum follower delta and percentage, trending lookback hours, minimum view spike (GET/PUT /api/alert-preferences). Impatient? POST /api/alerts/detect-now runs detection immediately.

How to set up monitoring

1. Add creators from any dossier or list with the Watch button (POST /api/watchlist — idempotent, watching twice is safe).
2. Watch three kinds of accounts: shortlisted candidates (catch momentum before negotiating), signed partners (verify they stay active), competitor-affiliated creators (see what rivals are doing).
3. Optionally set per-creator audience auto-refresh (PUT /api/watchlist/{username}/audience) for accounts where audience composition is deal-critical.
4. Check the digest weekly; act on alerts as they fire. Remove with DELETE /api/watchlist/{username} when a creator stops being relevant.

Typical scenarios

• Negotiation timing: a watched micro-creator triggers rising_kol with +18% followers in 7 days — you reach out this week, before their rate card catches up with their growth.
• Partner QA: a signed partner goes dormant mid-campaign — the badge shows up in the digest before the deliverable deadline is missed.
• Trend surfing: trending_video fires on a competitor-affiliated creator; you study the format the same day and brief your own creators.

Advanced usage

• Tune for your tier: default thresholds suit mid-size accounts; for nano scouting, lower min_follower_delta and raise the percentage so small-base growth registers.
• Agent briefings: via MCP, list_watchlist + list_alerts let Claude write your Monday digest in prose — “summarise watchlist changes and tell me who to contact first”.
• Loop with tracking: when trending_video fires, add the video to tracking (1 credit) to capture the full growth curve behind the alert.