TikTok account insights

curl --fail-with-body "https://app.tryadeli.com/api/v1/analytics/tiktok/account-insights?accountId=00000000-0000-4000-8000-000000000003&startDate=2026-09-01&endDate=2026-09-28" \ -H "Authorization: Bearer $ADELI_API_KEY"

{ "platform": "tiktok", "accountId": "00000000-0000-4000-8000-000000000003", "profileId": "00000000-0000-4000-8000-000000000001", "isBusinessAccount": true, "startDate": "2026-09-01", "endDate": "2026-09-28", "daily": [ { "date": "2026-09-01", "videoViews": 1126, "uniqueVideoViews": 900, "profileViews": 40, "likes": 26, "comments": 4, "shares": 1, "followers": 1204, "newFollowers": 6, "lostFollowers": 2, "engagedAudience": 120, "bioLinkClicks": 3, "emailClicks": 0, "phoneNumberClicks": 0, "addressClicks": 0, "appDownloadClicks": 0, "leadSubmissions": 0, "activity": [{ "hour": "18", "count": 52 }] } ], "audience": { "ages": [{ "key": "18-24", "percentage": 0.42 }], "genders": [{ "key": "Female", "percentage": 0.6 }], "countries": [{ "key": "US", "percentage": 0.75 }], "cities": [{ "key": "Austin", "percentage": 0.08 }] }, "fetchedAt": "2026-09-29T12:00:00.000Z" }

Returns the account's daily metrics and follower demographics for a window of complete UTC days. Needs the user.insights permission, which every connection made since Adeli moved to TikTok API for Business has granted.

Query parameters

accountIduuidRequired: A connected TikTok account.
profileIduuid: Optional, because accountId names its profile. If you pass both, they must agree.
startDateYYYY-MM-DD: First day, UTC. At most 60 days ago. Give both dates or neither; the default is the last 28 complete days.
endDateYYYY-MM-DD: Last day, UTC, before today and on or after startDate.

null means TikTok did not report it

TikTok's daily figures lag by 24 to 48 hours and exist only while Analytics is turned on in the TikTok app. Unique views, follower gains and losses, engaged audience, and activity are reported for Business Accounts only; the click metrics need a verified or registered business; demographics and activity need at least 100 followers. Anything TikTok withholds is null or an empty list, never 0.

activity is when followers were active, by hour. percentage values are fractions of 1.

Errors — 401 unauthorized, 400 invalid_request, 404 account_not_found, 404 profile_not_found, 422 connection_expired (also returned when the connection lacks user.insights; reconnecting fixes it), 422 provider_not_configured, 429 rate_limited, 502 provider_error.