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

Authentication

How to authenticate with the trackagoat v1 API using API key Bearer tokens.

PreviousOverviewNextErrors

On this page

  • Getting an API key
  • Using the key
  • Key format
  • Scoping
  • Errors

All v1 API requests require an API key. Keys are scoped to the organization of the user who created them.

Getting an API key

Generate a key in the app: Org settings → API keys → + New API key.

One-time reveal

The full key (tga_<64 hex chars>) is shown once at creation. Copy it immediately — trackagoat stores only a hash and cannot recover the plaintext.

See API keys guide for step-by-step instructions.

Using the key

Include the key as a Bearer token on every request:

bash
Authorization: Bearer tga_<your-key>

Example:

bash
curl -H "Authorization: Bearer tga_abc123" \
  https://www.trackagoat.com/api/v1/projects

Key format

text
tga_<64 lowercase hex characters>

Example: tga_a1b2c3d4e5f6... (64 hex chars after the prefix).

Scoping

Keys are org-scoped — all data returned is limited to the organization the key belongs to. There is no per-key scope system (no read-only vs write-only — all keys have the same access level within the org).

Errors

StatusCause
401Missing, invalid, or revoked key
403Key is valid but the org or user is banned
429Per-key sliding-window rate limit exceeded
json
{
  "data": null,
  "error": "Invalid or missing API key",
  "meta": null
}

API keys guide

Step-by-step instructions for creating and managing API keys.

Errors reference

Status codes, rate limits, and error response shapes.