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
DocsGuides

Limits & plan tiers

How trackagoat enforces per-organization and per-user limits based on plan tier, and how limits surface in the UI and API.

PreviousAPI keysNextNotifications

On this page

  • Plan tiers
  • Limit keys
  • How limits are enforced
  • When you hit a limit
  • Per-user limits
  • Requesting a raise

trackagoat enforces per-organization limits based on your plan tier. This page explains what each limit does, how they're enforced, and what happens when you hit one.

Plan tiers

TierCreatorsProjectsMembersAPI requests/dayManual scrapes/dayStats retention
Free5120130 days
Starter50351,00010365 days
Ultra300105050,000100Unlimited

Tier upgrades are handled manually. Email support@trackagoat.com with your org name and the tier you'd like.

Limit keys

LimitWhat it caps
max_creators_per_orgActive tracked creators across all projects
max_tracked_videos_per_orgIndividually tracked videos across all projects
max_projects_per_orgProjects in your org
max_members_per_orgTeam members in your org
max_campaigns_per_projectCampaigns per project
max_campaign_items_per_campaignItems per campaign
max_api_keys_per_orgActive API keys

How limits are enforced

Count limits (creators, projects, members, etc.) are enforced atomically — two concurrent requests cannot both succeed past the cap. You'll see a modal in the UI explaining which limit was hit.

Daily limits (API requests, manual scrapes) reset at UTC midnight. If you hit your daily API limit, requests return HTTP 429.

Scrape frequency floors (min_*_hours) set a minimum interval between scheduled scrapes — your configured frequency is clamped to no lower than the tier minimum. These floors do not apply to manual "Scrape Now" triggers, which are governed instead by max_manual_scrape_triggers_per_day. See How scraping works for a full breakdown of manual vs. automatic scraping.

Stats retention — a daily background job prunes history older than your retention window. Ultra tier has unlimited retention.

When you hit a limit

In the dashboard: A modal appears with the limit key, your current count, and the cap. If your org is retroactively over a limit (e.g., after a tier downgrade), a banner appears at the top of every page until the org is back within limits.

In the API: Count limits return HTTP 402:

json
{
  "data": null,
  "error": "Limit reached: max_creators_per_org",
  "meta": {
    "code": "limit_reached",
    "limitKey": "max_creators_per_org",
    "current": 5,
    "max": 5
  }
}

Daily rate limits return HTTP 429:

json
{
  "data": null,
  "error": "Rate limit exceeded",
  "meta": {
    "code": "rate_limit_exceeded",
    "retryAfter": 3421
  }
}

retryAfter is seconds until UTC midnight when the counter resets.

Per-user limits

One limit applies per user rather than per org:

LimitDescription
max_orgs_per_userMaximum orgs a user can belong to

The default is 6. If you need to belong to more orgs, contact support.

Requesting a raise

Limits are adjusted by the trackagoat team. There is no self-serve upgrade path yet.

To request a raise:

1

Email support

Email support@trackagoat.com with your org name and which limit you need raised.

2

Receive your override

We'll apply a per-org override. Overrides take effect immediately with no restart required.

max_api_requests_per_dayv1 API requests per UTC calendar day
max_manual_scrape_triggers_per_dayManual scrape triggers per UTC day
min_video_stats_hoursMinimum hours between video stats runs
min_discover_videos_hoursMinimum hours between video discovery runs
min_creator_profiles_hoursMinimum hours between creator profile scrapes
stats_history_retention_daysDays of stats history retained before pruning