Automate TikTok KOL discovery — Discovery Plans run daily for you

Why automate

A one-shot keyword search on the keyword phonecase on Monday surfaces the top 200 creators in that niche as of Monday. By Friday some have grown 2×, others have gone dark, and 30 new faces have crossed the engagement-rate threshold you care about. Re-running the search by hand every day is the kind of busywork SMM teams quietly drop after week three.

Discovery Plans take it off your plate. The keyword runs on its configured cadence, deduplicates against prior runs, applies the filters you set once, and lands the net-new matches in a KOL list — by the time you log in on Friday morning, the cohort is already a week broader.

Setting up a plan in 60 seconds

1. Go to /discovery-plans → New plan.
2. Required fields:
   • Plan name — internal label.
   • TikTok keyword — what to search.
   • Interval (hours) — 1-720 (30 days). 24 is the sensible default; the FYP refreshes daily, so does your cohort.
   • Max videos / run — 1-2000. 100 is the entry-level run (10 credits). Larger runs scale linearly.
3. Optional filters (the auto-add gates): min / max followers, require email. Creators failing the gate still show up on /kols but don't enter the target list.
4. Optional target KOL list. KOLens can create one inline if you don't have one yet.
5. Save. Plans default to draft (no auto-runs) — flip Activate on the detail page when you're ready.

The schedule pill

Every plan on /discovery-plans shows a colour-coded chip:

• Auto · every 24h · next in 3h (green) — actively scheduled.
• Paused — was every 24h (amber) — disabled, won't run until reactivated.
• Manual only · not scheduled (grey) — draft. Run-now works; the scheduler skips it.

Reading the results

Hit View results → on the plan detail page to see:

• Summary stats — total runs / successful / total videos / KOLs found / credits spent.
• Run history table — every job the plan has spawned, with per-run credits charged and links to that run's video grid.
• Aggregated video grid — every video across every run, deduped, with a per-tile badge linking back to the specific job each video came from.

Cost control

Two safeguards:

• Pre-charge per run — KOLens deducts credits when a run is queued, not after. Surprise bills are impossible.
• Out-of-credits auto-skip — if the plan owner's balance is below the run cost when the scheduler ticks, that tick is skipped (with a log line) and the schedule advances to the next slot. The plan retries on its normal cadence after the balance is topped up; it doesn't busy-loop or queue a backlog.

Run-now vs scheduled

Run now on the plan detail page spawns a one-off job immediately, without touching next_run_at. Works on any plan, including disabled / draft — useful for kicking off a manual cohort refresh before a campaign briefing without flipping the plan active.