TikTok Analytics · Get video metrics
tikhub/tiktok-analytics-fetch-video-metricsGet public social media posts, profiles and videos with TikTok Analytics · Get video metrics from TikHub through one Spiral API key. Retrieve detailed analytics data for TikTok videos, including views, likes, comments, and favorites. Provide total statistics and daily trends for 14 days since the release date, facilitating video performance analysis. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
$0.0013 per request.
Limits
- Runs
- In the background
- Returns
- json
- Longest queue wait
- 1 hour
- Run deadline
- 30 minutes
- Longest run, end to end
- 225 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
item_id required | text | — | Video id |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "tikhub",
"model": "tikhub/tiktok-analytics-fetch-video-metrics",
"input": {
"item_id": "7502551047378832671"
}
}'Frequently asked questions
How much does TikTok Analytics · Get video metrics cost?
$0.0013 per request. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use TikTok Analytics · Get video metrics through an API?
Send `POST /v1/runs` with `"provider": "tikhub"`, `"model": "tikhub/tiktok-analytics-fetch-video-metrics"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with TikHub to use TikTok Analytics · Get video metrics?
No. Spiral runs it on its own TikHub account and charges your Spiral balance.
Can my AI agent use TikTok Analytics · Get video metrics?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.