Get TikTok account-level insights
curl --request GET \
--url https://api.aisa.one/apis/v1/social/analytics/tiktok/account-insights \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/social/analytics/tiktok/account-insights"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/social/analytics/tiktok/account-insights', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/social/analytics/tiktok/account-insights",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/social/analytics/tiktok/account-insights"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aisa.one/apis/v1/social/analytics/tiktok/account-insights")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/social/analytics/tiktok/account-insights")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"accountId": "<string>",
"breakdown": "<string>",
"dataDelay": "<string>",
"dateRange": {
"since": "2023-12-25",
"until": "2023-12-25"
},
"metricType": "time_series",
"metrics": {},
"platform": "facebook",
"success": true,
"unavailableMetrics": [
{
"message": "<string>",
"metric": "<string>",
"reason": "not_enrolled"
}
]
}{
"error": {
"code": "<string>",
"details": {},
"message": "<string>",
"param": "<string>",
"retryHint": "never",
"retryable": true,
"type": "<string>"
}
}AIsa Social
Get TikTok account-level insights
Analytics. Read only; needs social:read. Ids are yours: accounts acc_..., profiles prf_..., posts pst_...; every other object id is checked against your accounts before the call.
Returns account-level TikTok insights from /v2/user/info/ (live) plus historical time series joined from AIsa's daily snapshotter (AccountStats).
- Response shape matches /apis/v1/social/analytics/instagram/account-insights.
- Max 89 days, defaults to last 30 days.
- Requires the user.info.stats scope on the account (412 if missing).
### Why the scope is narrow
This ACCOUNT-level endpoint intentionally exposes only the four counter metrics below. These account-level figures are not on any public TikTok API, for any account type:
- account-level impressions / reach
- follower inflow / outflow breakdown
- account-level watch time and audience demographics
TikTok's Research API doesn't expose them either, and is restricted to non-commercial academic use per TikTok's eligibility policy.
### Per-video metrics
PER-VIDEO is a different story on the Business lane. An account connected through the TikTok for Business app reports these per video on GET /apis/v1/social/analytics?postId=...:
- profile views, website clicks, follows
- full-watched rate, watch time
- impression sources, viewer types and viewer countries
They arrive roughly 24-48h after publishing and only for posts active in the last 7 days.
Accounts on the original TikTok integration get the basic counters there (views, likes, comments, shares) and zeros for the rest. They must reconnect through the Business app.
<!-- aisa-pricing:start -->
A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->
GET
https://api.aisa.one
/
apis
/
v1
/
social
/
analytics
/
tiktok
/
account-insights
Get TikTok account-level insights
curl --request GET \
--url https://api.aisa.one/apis/v1/social/analytics/tiktok/account-insights \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/social/analytics/tiktok/account-insights"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/social/analytics/tiktok/account-insights', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/social/analytics/tiktok/account-insights",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/social/analytics/tiktok/account-insights"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aisa.one/apis/v1/social/analytics/tiktok/account-insights")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/social/analytics/tiktok/account-insights")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"accountId": "<string>",
"breakdown": "<string>",
"dataDelay": "<string>",
"dateRange": {
"since": "2023-12-25",
"until": "2023-12-25"
},
"metricType": "time_series",
"metrics": {},
"platform": "facebook",
"success": true,
"unavailableMetrics": [
{
"message": "<string>",
"metric": "<string>",
"reason": "not_enrolled"
}
]
}{
"error": {
"code": "<string>",
"details": {},
"message": "<string>",
"param": "<string>",
"retryHint": "never",
"retryable": true,
"type": "<string>"
}
}Request contract
- Method and path: GET /apis/v1/social/analytics/tiktok/account-insights
- Availability: enabled
- Request URL template:
https://api.aisa.one/apis/v1/social/analytics/tiktok/account-insights - accountId: query; required
- metrics: query; optional
- fromDate: query; optional
- toDate: query; optional
- since: query; optional
- until: query; optional
- metricType: query; optional
- Runtime facts: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd
{
"operationId": "get_aisa_social_apis_v1_social_analytics_tiktok_a_d6b7cc",
"method": "GET",
"path": "/apis/v1/social/analytics/tiktok/account-insights",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [
{
"description": "One of your social accounts (acc_...).",
"in": "query",
"name": "accountId",
"required": true,
"schema": {
"pattern": "^acc_[0-9A-Za-z]{22}$",
"type": "string"
}
},
{
"description": "Comma-separated list. Defaults to\n\"follower_count,likes_count,video_count,followers_gained,followers_lost\".\n\nLive from /v2/user/info/ (requires user.info.stats scope):\n - follower_count (cumulative; time series joined from AccountStats)\n - following_count (cumulative; time series joined from AccountStats.metadata)\n - likes_count (cumulative; time series joined from AccountStats.metadata)\n - video_count (cumulative; time series joined from AccountStats.metadata)\n\nAIsa-synthesized:\n - followers_gained (sum of positive daily follower deltas)\n - followers_lost (sum of absolute negative daily deltas)",
"in": "query",
"name": "metrics",
"required": false,
"schema": {
"type": "string"
}
},
{
"description": "Start date (YYYY-MM-DD). Defaults to 30 days ago.",
"in": "query",
"name": "fromDate",
"required": false,
"schema": {
"format": "date",
"type": "string"
}
},
{
"description": "End date (YYYY-MM-DD). Defaults to today.",
"in": "query",
"name": "toDate",
"required": false,
"schema": {
"format": "date",
"type": "string"
}
},
{
"description": "Alias of fromDate, kept for existing callers",
"in": "query",
"name": "since",
"required": false,
"schema": {
"format": "date",
"type": "string"
}
},
{
"description": "Alias of toDate, kept for existing callers",
"in": "query",
"name": "until",
"required": false,
"schema": {
"format": "date",
"type": "string"
}
},
{
"description": "\"total_value\" returns the latest cumulative counter value.\n\"time_series\" returns daily values joined from AccountStats snapshots.",
"in": "query",
"name": "metricType",
"required": false,
"schema": {
"default": "total_value",
"enum": [
"time_series",
"total_value"
],
"type": "string"
}
}
],
"security": [
{
"bearerAuth": []
}
],
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"description": "Included with your connected social accounts: AIsa does not charge per call.",
"kind": "no_customer_charge"
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
Cost and request rules
A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
One of your social accounts (acc_...).
Pattern:
^acc_[0-9A-Za-z]{22}$Comma-separated list. Defaults to "follower_count,likes_count,video_count,followers_gained,followers_lost".
Live from /v2/user/info/ (requires user.info.stats scope):
- follower_count (cumulative; time series joined from AccountStats)
- following_count (cumulative; time series joined from AccountStats.metadata)
- likes_count (cumulative; time series joined from AccountStats.metadata)
- video_count (cumulative; time series joined from AccountStats.metadata)
AIsa-synthesized:
- followers_gained (sum of positive daily follower deltas)
- followers_lost (sum of absolute negative daily deltas)
Start date (YYYY-MM-DD). Defaults to 30 days ago.
End date (YYYY-MM-DD). Defaults to today.
Alias of fromDate, kept for existing callers
Alias of toDate, kept for existing callers
"total_value" returns the latest cumulative counter value. "time_series" returns daily values joined from AccountStats snapshots.
Available options:
time_series, total_value Response
Account insights data
Shared account-insights response envelope used by every platform-level analytics endpoint (/apis/v1/social/analytics/{facebook|instagram|youtube|linkedin|tiktok}/*). The name is historical - the shape was first shipped for Instagram and every new platform endpoint reuses it for response-shape consistency. The platform field echoes back which platform served the response.
One of your social accounts (acc_...).
Pattern:
^acc_[0-9A-Za-z]{22}$Breakdown dimension used (only present when breakdown was requested)
Show child attributes
Show child attributes
Available options:
time_series, total_value Object keyed by metric name.
- For time_series: each metric has "total" (number) and "values" (array of {date, value}).
- For total_value: each metric has "total" (number) and optionally "breakdowns" (array of {dimension, value}).
Monetary metrics also carry "unit" and "currency". AIsa never rescales money: "total" and every "values[].value" are the platform's raw numbers in the stated unit.
Monetary metrics keep "values" even on metricType=total_value, because their "total" is the sum of the daily buckets the platform returned over the range. Keep the series to reconcile that sum against the platform's own reporting before invoicing on it.
A metric that could not be served is absent from this object and listed in "unavailableMetrics" instead, so an unavailable metric is never reported as a zero.
Show child attributes
Show child attributes
Platform that served this response.
Available options:
facebook, instagram, youtube, linkedin, tiktok Requested metrics that could not be served. Present only when at least one metric is unavailable, absent otherwise.
Each listed metric is OMITTED from "metrics" rather than reported as 0, which is how an unavailable metric is distinguished from a genuine zero. The request itself still succeeds with HTTP 200.
Show child attributes
Show child attributes