Tracksuit API FAQ | Coach's Corner

Quick answers to the questions we hear most about the Tracksuit API. For more detail, start with the Tracksuit API overview or the Quick-start guide.

Do I need to be technical to use the API?

Yes. It's a REST API, so connecting it takes code or a low-code tool. Usually a job for your data team or agency. See Is the API right for you?

How do I get an API key?

In the Tracksuit dashboard, go to Account Settings → Tokens → Generate new token. You'll need admin access. Full steps are in the Authentication guide.

How long does my token last?

365 days from creation. There's no refresh mechanism so you'll need to generate a new token to replace it.

Why don't the API numbers exactly match my dashboard?

The API serves processed, weighted data, and small differences come from weighting and rounding. The most common cause is summing demographic slices. See Why API numbers may differ from the dashboard.

What data can I access?

Funnel metrics: awareness, consideration, preference and usage, over time
Demographics & cross-demographics: slice by age, gender, region, persona and more, including combinations
Multi-dashboard views: pull all trackers available to you into one view
Competitor brands in your category
Custom rolling average: anywhere from 1 to 12 months (the 1-month data point isn't available in the dashboard itself)
Statements: how your brand scores on brand imagery statements (the associations and attributes people link to your brand)
Conversion: conversion rates between funnel stages (e.g. how many of those aware of you go on to consider you)
Category profile: the demographic make-up behind a chosen metric, so you can see who sits at each stage of the funnel
Media consumption: which channels your category's audience consumes content on

The API does not currently include: Imagery data, Training Ground modules

Can I get raw, respondent-level data?

No, the Tracksuit API provides processed, weighted results, not individual survey responses.

Can I break the data down by audience, or by a single month?

Yes! You can filter by all demographics available in your tracker(s) and combine them. You can also set the rolling average anywhere from 1 to 12 months. A 1-month window gives a single, non-smoothed data point that isn't available in the dashboard.

How do I know a result is reliable?

Every data point includes a reliability indicator: Insufficient, Directional or Reliable. Use the minimum_indicator parameter to filter out points that don't meet the threshold you want.

Can I pull data for any brand, or only mine?

The API can only access brands in the trackers (or category-views) you have access to. This includes the competitors in those trackers.

Can I change the smoothing / rolling average?

Yes. smoothing defaults to 3 months (matching the dashboard) and can be set between 1 and 12 months.

Is statement data available as a time series?

Not in a single call but you can build a trend by calling across the periods you want.

However it's important to be aware of potential volatility. Statements are only asked of respondents who are already aware of the brand. If awareness is low, you may see high month-to-month volatility. We recommend using a 6-month rolling average when building this out.

How are my competitors and category defined?

Your category and competitor set are defined when your tracker is first set up, based on the brands and category important to your business. They're built into your tracker, so they can't be changed through the API.

How fresh is the data, and why do my dates error?

Data refreshes monthly with each survey wave and is dated to the 1st of the month. Use only the 1st of a month in start_period / end_period. Any other day returns an error. A given month isn't available until its wave has closed. See How data freshness & wave timing work.

If I pull the same period again later, will the value change?

No. Once a wave is published, its figures are stable from one pull to the next.

Can I change my tracker or write data back?

No, the Tracksuit API is read-only.

Does one API key cover all my brands?

Yes. A key can access every category view (tracker) the user who created it has access to. If you have multiple categories, brands or geographies, you will be able to access them all via the API and create comparison views.

Can I use the API with Claude or other AI tools?

An official Tracksuit MCP connector is coming soon, and it will be our recommended way to use Tracksuit data with AI tools. We recommend waiting for it rather than wiring up a direct connection now.

Are there rate limits?

Yes. Requests are limited to about 5 per second per user, with short bursts of up to 10. If you go over, you'll get an HTTP 429. Wait a moment, then retry with exponential backoff. Full detail, including what a 429 looks like, is in Tracksuit API rate limits.

I use the v1 API, do I need to migrate?

Yes. v2 is the foundation going forward. v1 becomes no-maintenance from 1 November 2026. This means there will be no bug fixes or support from this point onwards. Migration is roughly a 1–2 day job for most integrations. See the migration guide.

Is there a glossary or data dictionary?

Yes. See the Data dictionary for definitions of every metric and field.

Will the API cost anything to use?

No. The API is included in your existing Tracksuit dashboard subscription, at no extra cost.