trackagoat logotrackagoat/Docs

Getting started

  • Welcome
  • Quickstart
  • Core concepts

Guides

  • Creators
  • Videos
  • Campaigns
  • Creator Goals
  • Tracking Inbox
  • Content calendar
  • How scraping works
  • Analytics & metrics
  • Similar creator pools
  • Over-posting & suppression
  • Program Health
  • Sentiment Radar
  • API keys
  • Limits & plan tiers
  • Notifications
  • Payouts

API reference

  • Overview
  • Authentication
  • Errors
  • Projects
  • Creators
  • Videos
  • Campaigns
  • Analytics
  • Aggregate Analytics
  • Goal Compliance
  • Payouts
  • Schema

For agents

  • Agent guide
  • Data model
  • MCP & tooling

Platform

  • Brand
  • Changelog
  • Support
DocsGuides

Creators

Adding TikTok creators to your project, choosing tracking modes, working with notes and the change log, and monitoring goal compliance.

PreviousCore conceptsNextVideos

On this page

  • Adding a creator
  • Tracking modes
  • Creator detail tabs
  • Notes
  • Tracking start date
  • Auto-disabled creators
  • Removing a creator

Adding a creator

In your project, go to Creators → Add creator. You can add a creator by:

  • TikTok profile URL: https://www.tiktok.com/@username
  • Handle: @username or just username

trackagoat dispatches an initial update when a creator is added. The first stats snapshot typically appears within 1–2 minutes.

Creators are scoped to a project. The same TikTok account can be tracked in multiple projects within the same org.

Tracking modes

Each creator has a tracking mode that determines how newly discovered videos enter the system. The two modes are Auto and Selective.

ModeBehavior
AutoAll newly discovered videos are automatically added with status auto_tracked and included in stats.
SelectiveNewly discovered videos enter the Tracking Inbox with status pending_review. A team member must approve or exclude each video.

Change a creator's tracking mode from Creator detail → Settings tab.

Use Selective mode when you want to curate which of a creator's videos count toward your program: for example, if a creator posts off-topic content you don't want in your campaign stats.

Creator detail tabs

TabWhat you see
OverviewFollower count chart, total likes trend, posting frequency, and recent top videos.
VideosAll tracked videos for this creator, with their tracking status and current stats.
Creator GoalsPer-creator performance goals and compliance status. See Creator Goals.
Change logAutomatic events: follower milestones, tracking mode changes, goal compliance changes, creator added / re-activated / auto-disabled.
SettingsTracking mode, display name override, tracking start date, and danger zone (remove from project).

Notes

Every creator has a notes field: a free-form markdown editor for your team's context. Use it for:

  • Creator background, niche, and content focus
  • Relationship history and contact notes
  • Known issues (e.g. "tends to post late on Mondays")
  • Instructions for AI agents analyzing this creator

Notes are readable via the v1 API as the description field on creator objects.

AI agents read description fields before analyzing a creator. If you're using trackagoat with an AI tool, write clear notes: they directly shape the quality of agent analysis.

Tracking start date

The tracking start date sets the lower bound for stats history displayed in charts. If you added a creator mid-program, set this date to the program start so charts aren't misleading. Configurable in Creator → Settings.

Auto-disabled creators

If a creator fails 5 consecutive profile updates — usually because the TikTok handle was deleted, renamed, or made private — trackagoat automatically auto-disables them. An auto-disabled creator stops being updated so quota isn't wasted on a handle that may be gone, and is shown with an Auto-Disabled badge.

You can review auto-disabled creators on the Auto-Disabled Creators page (reachable from the creators list filter) or via the Tracking Gaps / Update Failures watchlists on Program Health.

To bring a creator back, an org admin clicks Re-enable. Re-enabling resets the failure counter and resumes updates. A 24-hour cooldown applies per creator: if a creator was re-enabled within the last 24 hours, you'll need to wait before re-enabling again. You can re-enable creators individually or in bulk.

If the handle changed, update it before re-enabling — otherwise the creator will simply fail again and be auto-disabled.

Removing a creator

Soft delete

In Creator → Settings → Danger zone, you can remove a creator from a project. This is a soft delete: stats history is preserved and the creator can be re-added. It does not count against your org's creator limit once removed.