> ## Documentation Index > Fetch the complete documentation index at: https://docs.adriel.com/llms.txt > Use this file to discover all available pages before exploring further. # Data reference > Metrics, breakdowns, refresh cadence, and limits for the TikTok Public data source in Adriel. ## Introduction TikTok Public pulls publicly visible creator-account data — profile statistics and per-video performance — for TikTok handles the customer designates as monitoring targets. The customer supplies no TikTok credential; the connection runs through a platform-managed proxy that aggregates public TikTok data. The connector is intended for competitive monitoring, influencer analytics, and brand-mention tracking on TikTok creators the customer does not own. Because TikTok's official API does not permit monitoring accounts the customer does not control, this connector uses a platform-managed public-data proxy for that use case. As a public-data connector, engagement metrics and audience breakdowns are standardized so widgets can aggregate alongside owned-account sources without additional configuration. To connect this data source, see [How to connect TikTok Public to Adriel](/data-sources/o-z/tiktok-public/how-to-connect). ## Data refresh strategy ### Architecture data The list of monitored TikTok handles is configured per data source by the customer. Multiple handles can be tracked per data source, and the handle is the unit of monitoring — per-video metrics are fetched for the videos that resolve under each tracked handle. Changes to the monitored handle list take effect on the next scheduled refresh. ### Reports data This connector follows a simple-cache pattern: every day, for each collection, data is refetched and the cache is overwritten. The default refresh runs once daily at **5:00 PM (UTC)**. Public TikTok data is exposed as snapshot-style counts — followers, total likes, video counts — rather than a historical daily time series, so cached values accumulate from the day the monitored handle is first added. A manual cache refresh is also available, limited to once per calendar day. ## Architecture levels Creator (handle) → Video ## Metrics **How to read the columns** **Data type** uses this vocabulary: Number, Currency, Percentage, Ratio, Duration, Date, Text, URL, Array, Boolean. **API Key** in code style like `stats.playCount` is the literal platform field name. *Italic text* describes how a value is produced when it doesn't map cleanly to a single API field. ### Video performance | Metric | Description | Data type | API Key | | -------------- | -------------------------------- | --------- | -------------------- | | Views | Per-video view count. | Number | `stats.playCount` | | Likes | Per-video like count. | Number | `stats.diggCount` | | Comments | Per-video comment count. | Number | `stats.commentCount` | | Shares | Per-video share count. | Number | `stats.shareCount` | | Video duration | Length of the video in seconds. | Duration | `video.duration` | | Published at | Publish timestamp for the video. | Date | `createTime` | ### Video metadata | Metric | Description | Data type | API Key | | ----------------- | ----------------------------------------- | --------- | ------------------ | | Post ID | TikTok-assigned identifier for the video. | Text | `id` | | Post description | Caption text posted with the video. | Text | `desc` | | Post video URL | Playable URL for the video. | URL | `video.playAddr` | | Post cover image | Thumbnail image for the video. | URL | `video.cover` | | Music title | Title of the sound used in the video. | Text | `music.title` | | Music author name | Author of the sound used in the video. | Text | `music.authorName` | ### Creator statistics | Metric | Description | Data type | API Key | | --------------- | --------------------------------------------------------------- | --------- | ---------------------- | | Follower count | Public follower count for the monitored handle. | Number | `stats.followerCount` | | Following count | Number of accounts the monitored handle follows. | Number | `stats.followingCount` | | Total likes | Cumulative like count across all of the handle's public videos. | Number | `stats.heartCount` | | Video count | Total public videos published by the handle. | Number | `stats.videoCount` | ### Creator metadata | Metric | Description | Data type | API Key | | ---------------- | ----------------------------------------------------- | --------- | ------------------ | | Creator nickname | Display name of the monitored creator. | Text | `data.nickname` | | Creator handle | Unique username (handle) of the monitored creator. | Text | `data.uniqueId` | | Creator ID | TikTok-assigned identifier for the monitored creator. | Text | `id` | | Creator avatar | Profile avatar image for the creator. | URL | `data.avatarThumb` | ## Breakdowns ### Video | Breakdown | Description | API Key | | ---------------- | ---------------------------------- | ---------------- | | Post ID | Group by individual video. | `id` | | Post description | Group by video caption text. | `desc` | | Post video URL | Group by the video's playable URL. | `video.playAddr` | ### Creator | Breakdown | Description | API Key | | ---------------- | --------------------------------------- | --------------- | | Creator nickname | Group by the creator's display name. | `data.nickname` | | Creator handle | Group by the creator's unique username. | `data.uniqueId` | ## Limitations * **90 videos per handle** — Adriel caps fetching at the 90 most recent public videos per handle per refresh cycle. Metrics are available for those videos only. * **Snapshot semantics, not a time series** — public counts (followers, total likes, video count) are captured at refresh time and stored as daily snapshots. Historical values for periods before the monitored handle was added are not available. * **Username changes require recreation** — if a monitored creator changes their TikTok handle, any data source linked to the old handle must be recreated. * **Private or deleted accounts stop updating** — if a monitored creator switches the account to private or deletes it, new data stops arriving. Data already in the cache remains queryable until the situation changes. * **Shared, aggregate usage cap** — the third-party proxy subscription has aggregate limits that span all customers using the connector. Heavy concurrent load may surface as throttling or temporarily stale data; contact support if throttling is suspected. * **Narrower than TikTok Organic** — public scraping exposes only the metrics TikTok shows on the public web. There is no access to audience demographics, traffic sources, or impression breakdowns that a creator's own analytics surface. ## API references * The connector reads public TikTok data through a platform-managed RapidAPI proxy (host `tiktok-api23.p.rapidapi.com`, base URL `https://tiktok-api23.p.rapidapi.com/api/`). The RapidAPI subscription is managed by Adriel; the customer never supplies a TikTok credential. * [RapidAPI](https://rapidapi.com/) — the gateway through which public TikTok data is aggregated. ## See also * [How to connect TikTok Public to Adriel](/data-sources/o-z/tiktok-public/how-to-connect) (paired how-to) * [TikTok Ads data reference](/data-sources/o-z/tiktok/data-reference) — for paid TikTok campaigns * [TikTok Organic data reference](/data-sources/o-z/tiktok-organic/data-reference) — for accounts the customer administers directly