TikTok Analytics
warning
Analytics endpoints are not available on the Basic plan. Upgrade to Intermediate, Growth or Business plan to access these endpoints.
TikTok analytics endpoints provide insights for your connected TikTok accounts.
1. GET /api/tiktok/overview
Returns account-level metrics with current vs. previous period comparison.
Sample Request
curl --location --request GET \
"https://analyze.oneupapp.io/api/tiktok/overview?apiKey=YOUR_API_KEY&social_network_id=123&preset=last_30_days"
Sample Response
{
"success": true,
"data": {
"metrics": [
{
"key": "posts",
"name": "Posts",
"value_current_period": 15,
"value_last_period": 12,
"percentage_change": "+25.0%",
"description": "Total number of posts in this period"
},
{
"key": "views",
"name": "Views",
"value_current_period": 125000,
"value_last_period": 100000,
"percentage_change": "+25.0%",
"description": "Total number of views on your videos"
},
{
"key": "likes",
"name": "Likes",
"value_current_period": 5500,
"value_last_period": 4500,
"percentage_change": "+22.2%",
"description": "The number of likes on your videos"
},
{
"key": "comments",
"name": "Comments",
"value_current_period": 280,
"value_last_period": 220,
"percentage_change": "+27.3%",
"description": "The number of comments on your videos"
},
{
"key": "shares",
"name": "Shares",
"value_current_period": 420,
"value_last_period": 340,
"percentage_change": "+23.5%",
"description": "The number of times your videos were shared"
},
{
"key": "saves",
"name": "Saves",
"value_current_period": 180,
"value_last_period": 150,
"percentage_change": "+20.0%",
"description": "The number of times your videos were saved"
}
],
"total_followers": 25000,
"post_performance": {
"most_engaging": [],
"least_engaging": [],
"most_views": [],
"least_views": [],
"most_shared": [],
"least_shared": []
}
}
}
Metrics
| Key | Name | Description |
|---|---|---|
posts | Posts | Total posts published |
views | Views | Total number of views on your videos |
likes | Likes | The number of likes on your videos |
comments | Comments | The number of comments on your videos |
shares | Shares | The number of times your videos were shared |
saves | Saves | The number of times your videos were saved |
2. GET /api/tiktok/posts
Returns analytics for individual posts.
Sample Request
curl --location --request GET \
"https://analyze.oneupapp.io/api/tiktok/posts?apiKey=YOUR_API_KEY&social_network_id=123&preset=last_30_days"
Sample Response
{
"success": true,
"data": {
"stats": [
{
"key": "posts",
"name": "Posts",
"value_current_period": 15,
"value_last_period": 12,
"percentage_change": "+25.0%",
"description": "Total number of posts in this period"
},
{
"key": "views",
"name": "Views",
"value_current_period": 125000,
"value_last_period": 100000,
"percentage_change": "+25.0%",
"description": "Total number of views on your videos"
},
{
"key": "likes",
"name": "Likes",
"value_current_period": 5500,
"value_last_period": 4500,
"percentage_change": "+22.2%",
"description": "The number of likes on your videos"
},
{
"key": "comments",
"name": "Comments",
"value_current_period": 280,
"value_last_period": 220,
"percentage_change": "+27.3%",
"description": "The number of comments on your videos"
},
{
"key": "shares",
"name": "Shares",
"value_current_period": 420,
"value_last_period": 340,
"percentage_change": "+23.5%",
"description": "The number of times your videos were shared"
},
{
"key": "saves",
"name": "Saves",
"value_current_period": 180,
"value_last_period": 150,
"percentage_change": "+20.0%",
"description": "The number of times your videos were saved"
},
{
"key": "average_time_watched",
"name": "Average Watch Time",
"description": "The views-weighted average time viewers spent watching the video.",
"format": "duration",
"value_current_period": "2.95s",
"value_last_period": "2.88s",
"percentage_change": "+2%"
},
{
"key": "total_time_watched",
"name": "Total Watch Time",
"description": "The total time viewers spent watching videos in this period.",
"format": "duration",
"value_current_period": "39m 45s",
"value_last_period": "1h 24m 7s",
"percentage_change": "-53%"
},
{
"key": "full_video_watched_rate",
"name": "Completion Rate",
"description": "The views-weighted percentage of viewers who watched the full video.",
"format": "percentage",
"value_current_period": 18.9407098381071,
"value_last_period": 0.6066361556064073,
"percentage_change": "+3,022%"
},
{
"key": "retention_1s",
"name": "1-Second Retention",
"description": "The views-weighted percentage of viewers still watching after one second.",
"format": "percentage",
"value_current_period": 52.1858407079646,
"value_last_period": 62.34757505773672,
"percentage_change": "-16%"
},
{
"key": "retention_2s",
"name": "2-Second Retention",
"description": "The views-weighted percentage of viewers still watching after two seconds.",
"format": "percentage",
"value_current_period": 19.979351032448378,
"value_last_period": 32.891454965357966,
"percentage_change": "-39%"
},
{
"key": "retention_3s",
"name": "3-Second Retention",
"description": "The views-weighted percentage of viewers still watching after three seconds.",
"format": "percentage",
"value_current_period": 12.99410029498525,
"value_last_period": 22.864896073903,
"percentage_change": "-43%"
},
{
"key": "average_percentage_watched",
"name": "Average Percentage Watched",
"description": "Average watch time divided by video duration, weighted by video views.",
"format": "percentage",
"value_current_period": 2.835794670857269,
"value_last_period": 4.750822969976248,
"percentage_change": "-40%"
}
],
"posts": [
{
"id": "video_7123456789",
"page_id": "tiktok_account_123",
"format": "video",
"text": "Viral dance challenge",
"permalink": "https://tiktok.com/@user/video/7123456789",
"media_type": "VIDEO",
"media_url": "https://example.com/tiktok.jpg",
"stats": {
"reach": 62,
"shares": 0,
"likes": 0,
"comments": 0,
"video_views": 68,
"video_duration": 1.4086666666666665,
"average_time_watched": 0.06183333333333333,
"total_time_watched": 4.266666666666667,
"full_video_watched_rate": 1.4500000000000002,
"retention_1s": 53,
"retention_2s": 28.999999999999996,
"retention_3s": 16,
"average_percentage_watched": 4.38949361097965
},
"timestamp": "2025-05-01 15:00:00"
}
]
}
}
Post Stats
| Field | Description |
|---|---|
reach | Number of accounts reached |
video_views | Number of video views |
likes | Number of likes |
comments | Number of comments |
shares | Number of shares |
video_duration | Video duration in seconds |
average_time_watched | Average time watched in seconds |
total_time_watched | Total time watched in seconds |
full_video_watched_rate | Percentage of viewers who watched the full video |
retention_1s | Percentage of viewers still watching after one second |
retention_2s | Percentage of viewers still watching after two seconds |
retention_3s | Percentage of viewers still watching after three seconds |
average_percentage_watched | Average percentage of the video watched |
3. GET /api/tiktok/demographics
Returns audience demographic data.
Sample Request
curl --location --request GET \
"https://analyze.oneupapp.io/api/tiktok/demographics?apiKey=YOUR_API_KEY&social_network_id=123&preset=last_30_days"
Sample Response
{
"success": true,
"data": [
{
"key": "age_group_demographics",
"name": "Followers by Age",
"data": [
{
"name": "18-24",
"value": 10000,
"percentage": 40.0,
"share": 40.0
},
{
"name": "25-34",
"value": 8750,
"percentage": 35.0,
"share": 35.0
},
{
"name": "13-17",
"value": 3750,
"percentage": 15.0,
"share": 15.0
},
{
"name": "35-44",
"value": 1750,
"percentage": 7.0,
"share": 7.0
},
{
"name": "45-54",
"value": 500,
"percentage": 2.0,
"share": 2.0
},
{
"name": "55+",
"value": 250,
"percentage": 1.0,
"share": 1.0
}
]
},
{
"key": "gender_demographics",
"name": "Followers by Gender",
"data": [
{
"name": "Female",
"value": 15000,
"percentage": 60.0,
"share": 60.0
},
{
"name": "Male",
"value": 10000,
"percentage": 40.0,
"share": 40.0
}
]
},
{
"key": "country_demographics",
"name": "Followers by Country",
"data": [
{
"name": "United States",
"value": 10000,
"percentage": 40.0,
"share": 40.0
},
{
"name": "United Kingdom",
"value": 3750,
"percentage": 15.0,
"share": 15.0
},
{
"name": "Canada",
"value": 2500,
"percentage": 10.0,
"share": 10.0
}
]
},
{
"key": "city_demographics",
"name": "Followers by City",
"data": [
{
"name": "New York",
"value": 2500,
"percentage": 10.0,
"share": 10.0
},
{
"name": "Los Angeles",
"value": 2000,
"percentage": 8.0,
"share": 8.0
},
{
"name": "London",
"value": 1750,
"percentage": 7.0,
"share": 7.0
}
]
}
]
}
Demographics Data
| Field | Description |
|---|---|
name | Demographic segment name |
value | Count or absolute number |
percentage | Percentage value |
share | Share percentage (same as percentage) |
✅ Result: You have successfully retrieved TikTok analytics data!