TikTok Analytics
warning
Analytics endpoints are not available on the Starter 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"
}
],
"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": {
"views": 8333,
"likes": 367,
"comments": 19,
"shares": 28,
"saves": 12
},
"timestamp": "2025-05-01 15:00:00"
}
]
}
}
Post Stats
| Field | Description |
|---|---|
views | Number of views |
likes | Number of likes |
comments | Number of comments |
shares | Number of shares |
saves | Number of saves |
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!