API resource

TikTok

TikTok-only reads: account insights, the commercial music library for business accounts, and location tags. TikTok creator info lives under Accounts.

Get TikTok account-level insights

GET/v1/analytics/tiktok/account-insights

Works on: TikTok

Returns account-level TikTok insights from /v2/user/info/ (live) plus historical time series joined from Creator OS's daily snapshotter (AccountStats). Response shape matches /v1/analytics/instagram/account-insights. Max 89 days, defaults to last 30 days. Requires analytics access on your plan and the user.info.stats scope on the account (412 if missing). Scope intentionally narrow: this ACCOUNT-level endpoint exposes only the four counter metrics below.

Query parameters

accountIdstringrequired

The account id for the TikTok account.

metricsstring

Comma-separated list. Defaults to "follower_count,likes_count,video_count,followers_gained,followers_lost".

fromDatestring

Start date (YYYY-MM-DD). Defaults to 30 days ago.

toDatestring

End date (YYYY-MM-DD). Defaults to today.

sincestring

Alias of fromDate, kept for existing callers

untilstring

Alias of toDate, kept for existing callers

metricTypestring

"total_value" returns the latest cumulative counter value. "time_series" returns daily values joined from AccountStats snapshots.

curl "https://creatoros-production-5658.up.railway.app/v1/analytics/tiktok/account-insights?accountId=acc_Q3n1PvR8dKc0Zb7LwY4sHx2mJt9Eg6Ua5Nf1Ck8Tq3Vz" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"

Response 200

{
  "success": true,
  "accountId": "acc_Q3n1PvR8dKc0Zb7LwY4sHx2mJt9Eg6Ua5Nf1Ck8Tq3Vz",
  "platform": "tiktok",
  "dateRange": {
    "since": "string",
    "until": "string"
  },
  "metricType": "time_series",
  "breakdown": "string",
  "metrics": {},
  "unavailableMetrics": [
    {
      "metric": "string",
      "reason": "not_enrolled",
      "message": "string"
    }
  ],
  "dataDelay": "Data may be delayed up to 48 hours"
}

List trending commercial music

GET/v1/accounts/{accountId}/tiktok/commercial-music

Works on: TikTok

Returns the 100 currently trending tracks of TikTok's Commercial Music Library for a TikTok account connected through the TikTok for Business app. Use a track id as tiktokSettings.musicSoundInfo.musicSoundId when creating a post. The list is not paged; countryCode selects the country chart.

Path parameters

accountIdstringrequired

The TikTok account ID

Query parameters

countryCodestring

Two-letter ISO 3166-1 country code of the chart to read (for example ES). Defaults to TikTok's global chart.

curl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_Q3n1PvR8dKc0Zb7LwY4sHx2mJt9Eg6Ua5Nf1Ck8Tq3Vz/tiktok/commercial-music" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"

Response 200

{
  "tracks": [
    {
      "id": "string",
      "commercialMusicId": "string",
      "name": "string",
      "artist": "string",
      "durationSec": 0,
      "genres": [
        "string"
      ],
      "previewUrl": "string",
      "thumbnailUrl": "string",
      "rank": 0,
      "clip": {
        "id": "string",
        "durationSec": 0,
        "previewUrl": "string"
      }
    }
  ]
}

Search TikTok location tags

GET/v1/accounts/{accountId}/tiktok/locations

Works on: TikTok

Searches the location tags a TikTok account connected through the TikTok for Business app can attach to a video post. Send a result's id and name as tiktokSettings.locationId and locationName when creating a post. TikTok answers the 20 closest matches and fills the list with fuzzy matches when nothing matches, so an unrelated result does not mean the place is missing.

Path parameters

accountIdstringrequired

The TikTok account ID

Query parameters

querystringrequired

Place name to search, for example a city, a venue or an address

curl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_Q3n1PvR8dKc0Zb7LwY4sHx2mJt9Eg6Ua5Nf1Ck8Tq3Vz/tiktok/locations?query=%3Cquery%3E" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"

Response 200

{
  "locations": [
    {
      "id": "string",
      "name": "string",
      "address": "string"
    }
  ]
}

PreviousInstagram NextYouTube