input | string | object | Input The input item this record corresponds to. |
status | string | Status ok (auditType full or profile-only, charged) | not_found (unknown account, not charged) | error | skipped_invalid | skipped_budget | skipped_free_plan e.g. "ok" |
charged | boolean | Charged Whether this record incurred a pay-per-event charge. |
chargedEvent | string | Charged event Pay-per-event event charged for this record. |
source | string | Source Upstream data source (scrapecreators = ScrapeCreators, public TikTok data). |
fetchedAt | string | Fetched at ISO timestamp. |
error | object | Error code / message when status is not ok (or a partial failure). |
warnings | array | Warnings Non-fatal notes (partial data, stopped early, free-plan caps). |
found | boolean | null | Found Account exists. |
auditType | string | null | Audit type full (profile + video stats) or profile-only (private / no videos / videos unavailable). |
handle | string | null | Handle TikTok username. |
userId | string | null | User id Numeric TikTok id. |
secUid | string | null | secUid TikTok secure user id. |
profileUrl | string | null | Profile URL https://www.tiktok.com/@<handle>. |
nickname | string | null | Nickname Display name. |
bio | string | null | Bio Profile bio. |
bioLink | string | null | Bio link Link in bio. |
followers | integer | null | Followers Follower count. |
following | integer | null | Following Accounts followed. |
likes | integer | null | Total likes Lifetime likes received. |
videoCount | integer | null | Videos Total videos. |
friendCount | integer | null | Friends Mutual follows. |
isVerified | boolean | null | Verified Verified badge. |
isPrivate | boolean | null | Private Private account. |
isOrganization | boolean | null | Organization Organization account. |
isCommerceUser | boolean | null | Commerce Commerce / seller account. |
avatarUrl | string | null | Avatar Avatar image URL. |
region | string | null | Region Account region. |
language | string | null | Language Account language. |
createdAt | string | null | Created Account creation date (ISO), when reported. |
sampleSizeRequested | integer | null | Sample size requested sampleSize input. |
videosAnalyzed | integer | null | Videos analyzed Latest videos in the sample (pinned excluded). |
pinnedExcluded | integer | null | Pinned excluded Pinned videos left out of the stats. |
avgViews | integer | null | Avg views Mean plays per sampled video. |
medianViews | number | null | Median views Median plays per sampled video. |
avgLikes | number | null | Avg likes Mean likes per sampled video. |
avgComments | number | null | Avg comments Mean comments per sampled video. |
avgShares | number | null | Avg shares Mean shares per sampled video. |
avgSaves | number | null | Avg saves Mean saves (collects) per sampled video. |
engagementRatePct | number | null | Engagement rate % (avgLikes + avgComments + avgShares) ÷ followers × 100. |
engagementRateByViewsPct | number | null | Engagement / views % Σ(likes + comments + shares) ÷ Σ plays × 100. |
viewsPerFollowerPct | number | null | Views / follower % avgViews ÷ followers × 100. |
postingFrequencyPerWeek | number | null | Posts per week Sampled videos ÷ weeks from the oldest sampled video to fetch time. |
sampleWindowDays | number | null | Sample window (days) Days from the oldest sampled video to fetch time. |
avgDurationSecs | integer | null | Avg duration (s) Mean video length. |
topVideos | array | Top videos Up to 3 most played sampled videos { videoId, url, description, views, likes, createdAt }. |
topHashtags | array | Top hashtags Up to 10 { tag, count }: sampled videos using the hashtag. |
topSounds | array | Top sounds Up to 5 { sound, count } ('title — author'). |
paidPartnershipSharePct | number | null | Paid partnership % Share of sampled videos flagged as paid partnership (when reported). |
postingHoursUtc | array | Posting hours (UTC) { hourUtc, posts, avgEngagement } for each hour with posts. |
bestPostingHourUtc | integer | null | Best hour (UTC) Hour with the highest mean likes + comments + shares (hours with ≥ 2 videos preferred). |
mostActivePostingHourUtc | integer | null | Most active hour (UTC) Hour with the most sampled videos. |
newestVideoAt | string | null | Newest video ISO. |
oldestVideoAt | string | null | Oldest sampled video ISO. |
pagesFetched | integer | null | Pages fetched Video feed pages fetched. |
extraPagesCharged | integer | null | Extra pages charged Pages charged as tiktok-audit-extra-page. |
sampleStopReason | string | null | Sample stop reason limit | end | budget | deadline | aborted | empty_pages | max_pages | error. |
videos | array | Sampled videos Only with includeVideos: normalized videos (plays, likes, comments, shares, saves, hashtags, sound…). |