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
  • Payouts
  • Schema

For agents

  • Agent guide
  • Data model
  • MCP & tooling

Platform

  • Brand
  • Changelog
  • Support
DocsGetting started

Core concepts

Understand how organizations, projects, creators, videos, campaigns, and goals fit together in trackagoat.

PreviousQuickstartNextCreators

On this page

  • Data model
  • Organization
  • Project
  • Creator
  • Video
  • Campaign
  • Goal
  • API key
  • Next steps

Data model

trackagoat is organized in a hierarchy:

text
Organization
  └── Project(s)
        ├── Creator(s)   — TikTok accounts being tracked
        │     └── Video(s) — videos discovered from this creator
        ├── Video(s)     — videos added directly by URL
        └── Campaign(s)  — named groupings of creators, videos, and sub-campaigns

Organization

An organization is the root of your workspace. All creators, projects, campaigns, and API keys belong to an org. Your subscription tier (Free / Starter / Ultra) is set per org and determines your limits.

You can belong to multiple orgs. Roles within an org are admin (can manage members, settings, and API keys) or member.

Project

A project groups creators and campaigns for a specific program or time period. Examples: Q1 Brand Program, Holiday Campaign 2026, Always-On Ambassadors.

Each project has:

  • A creators list — TikTok accounts being tracked in this project
  • A videos list — individual videos tracked in this project (discovered automatically or added manually)
  • Campaigns — named groupings you can analyze together
  • Creator Goals — per-project goal overview
  • An inbox — videos in pending_review status waiting for your approval

Creator

A creator is a TikTok account being tracked. Each creator has:

  • A tracking mode (auto or selective) that controls how newly discovered videos enter the system
  • A stats history — snapshots of follower count, total likes, and video count over time
  • A goals list — per-creator performance targets
  • A change log — automatic events when notable things happen (follower milestones, goal compliance changes)
  • A notes field — free-form markdown for your team's context

Video

A video is an individual TikTok post. Each video has:

  • Stats: view_count, like_count, comment_count, share_count
  • A tracking status that controls whether it's included in campaign and project stats

Tracking statuses

StatusMeaning
auto_trackedDiscovered automatically; included in all stats
pending_reviewDiscovered but waiting for manual review (selective mode)
includedManually approved; included in stats
excludedManually excluded; not counted in stats
direct_addAdded directly by URL; always included

Campaign

A campaign is a named grouping of creators, videos, and/or other campaigns. It has aggregate stats that recursively sum across all items — you don't need to manually aggregate sub-campaigns.

Campaigns can nest: a campaign can contain sub-campaigns. trackagoat resolves the full tree when computing stats, and prevents circular references.

Common uses:

  • A brand partnership that groups several creators
  • A monthly drop that groups specific videos
  • A nested hierarchy like 2026 Program → Q1 → January Launch

Goal

A goal is a per-creator performance target. Examples:

  • Post at least 3 videos per week
  • Maintain a minimum view count per video
  • Hit a follower count milestone

trackagoat tracks compliance — whether a creator is meeting the goal — and surfaces non-compliant creators in the goals overview.

API key

API keys give programmatic read access to your org's data. Keys are scoped to the organization of the user who created them. A key is shown once at creation and cannot be recovered.

See API keys and the API reference for details.

Next steps

Quickstart

Get your first creator tracked in minutes.

Creators guide

Add TikTok creators, configure tracking modes, and monitor performance.

API reference

Read-only v1 API for programmatic access to your org's data.