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
DocsAPI reference

API overview

Base URL, response envelope, pagination, date ranges, and API versioning.

PreviousPayoutsNextAuthentication

On this page

  • Authentication
  • Response envelope
  • Pagination
  • Date ranges
  • Available endpoints

The trackagoat v1 API gives programmatic read access to your organization's data. All endpoints are under /api/v1/ and require API key authentication.

Base URL: https://www.trackagoat.com/api/v1

The apex domain trackagoat.com redirects to www.trackagoat.com. Always use www.trackagoat.com as your base URL to avoid redirect overhead.

Authentication

See Authentication for how to generate and use API keys.

Response envelope

Every endpoint returns JSON with this shape:

json
{
  "data": <payload or null>,
  "error": <error string or null>,
  "meta": <pagination info or null>
}

Successful responses have data set and error: null. Error responses have data: null and error set to a message string.

Pagination

List endpoints use cursor-based pagination:

bash
GET /api/v1/creators?limit=50&cursor=<value>
ParameterDefaultMaxDescription
limit50100Items per page
cursor——Pass meta.nextCursor from the previous response

The meta object on list responses:

json
{
  "hasMore": true,
  "nextCursor": "2026-03-15T10:00:00Z"
}

Keep fetching until meta.hasMore is false.

Date ranges

Stats endpoints accept ?from=YYYY-MM-DD&to=YYYY-MM-DD. Both default to the last 30 days if omitted.

bash
GET /api/v1/creators/uuid/stats?from=2026-01-01&to=2026-03-31

Available endpoints

MethodPathDescription
GET/api/v1/projectsList projects
GET/api/v1/creatorsList creators
PATCH/api/v1/creators/{id}Update creator notes (readme field)
GET/api/v1/creators/{id}/statsCreator stats history
GET

Authentication

API key setup and Bearer token usage.

Errors

Status codes, rate limits, and error handling.

/api/v1/videos
List tracked videos
PATCH/api/v1/videos/{id}Update video notes (readme field)
GET/api/v1/campaignsList campaigns
PATCH/api/v1/campaigns/{id}Update campaign notes (readme field)
GET/api/v1/campaigns/{id}/statsCampaign aggregate stats
GET/api/v1/schemaMachine-readable data model

Schema

Machine-readable data model for agents.