Read TikTok engagement history
tiktok_seriesRead the stored per-post history for an account you own: the full time series for one video (video_id), per-video growth over a window (hours), or the latest sample per video (neither). Samples come from tiktok_analytics runs, so history exists only for what you have scraped. Costs 0.001 USDC, paid per-action via x402.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"account_id": "<account_id>"
},
"name": "tiktok_series"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hours | No | Return per-video growth over the last N hours | |
| payment | No | base64 x402 payment payload (X-PAYMENT); omit on first call to receive payment instructions | |
| video_id | No | Return the full sample series for this one video | |
| account_id | Yes | Your identifier for the TikTok account |