Skip to main content
This tutorial sets up a competitor watch list: you’ll create a creator to act as the group, start tracking each competitor’s account, link the accounts to the group, and then compare the whole set over time with a single timeseries call.
Read fields off the live responses rather than assuming names — created resources return the id you’ll need for the next step. You’ll need an API key first — see API setup or create one on the API keys page.
1

Create the competitor group

POST /v2/creators makes the group you’ll attach competitors to. Send an Idempotency-Key so a retry doesn’t create a duplicate group, and read the new creator’s id from the response.
curl -X POST "https://api.creatoraudit.com/v2/creators" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: competitor-set-2026-q2" \
  -d '{ "name": "Competitor set" }'
2

Track each competitor account

POST /v2/accounts takes a platform (instagram or tiktok) and a username. Call it once per competitor handle, each with its own Idempotency-Key keyed to the handle, and read each new account id from the response.
curl -X POST "https://api.creatoraudit.com/v2/accounts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: track-instagram-rival_one" \
  -d '{ "platform": "instagram", "username": "rival_one" }'
3

Link the accounts to the group

PUT /v2/creators/{id}/accounts/{account_id} attaches an account to the group. Call it once per account id you collected.
curl -X PUT "https://api.creatoraudit.com/v2/creators/CREATOR_ID/accounts/ACCOUNT_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
To remove a competitor later, DELETE /v2/creators/{id}/accounts/{account_id} detaches the account from the group without deleting the account itself.
4

Compare the set over time

GET /v2/creators/{id}/analytics/timeseries returns the group’s metrics as a time series. Pass a period of 7d, 30d, or 90d — or period=custom with start_date and end_date — and read the series off the live response to chart the competitor set against your own.
curl "https://api.creatoraudit.com/v2/creators/CREATOR_ID/analytics/timeseries?period=30d" \
  -H "Authorization: Bearer YOUR_API_KEY"
A freshly tracked account starts with last_scrape_time: null and no metrics until its first refresh lands — so the timeseries will be sparse right after you set up the group, then fill in over the following scrape cycles. See Data freshness for the timing before you read too much into an empty chart.

Data freshness

Why a new competitor’s metrics lag, and when they appear.

Concepts

How creators, accounts, and metrics relate.

Creators dashboard

Manage the same groups in the app.