tiktok/creator/video-audience-stats
Retrieve audience profile statistics for a specified TikTok video, including gender distribution, age distribution, and regional distribution.. Useful for accurately understanding the characteristics of the video audienc...
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runtiktok/creator/video-audience-statsInput Schema
4 parameters · 1 required · 3 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
item_id | string | Required | Video ID |
proxy | union | Optional | Optional HTTP Proxy Address |
cookie | string | Optional | User Cookie String |
start_date | string | Optional | Query Start Date, e.g. '04-01-2025' |
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Code Examples
Ready-to-run snippets
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "tiktok/creator/video-audience-stats",
"prompt": "a beautiful sunset over mountains"
}'API README
Get Video Audience Analysis Data
Retrieve audience profile statistics for a specified TikTok video, including gender distribution, age distribution, and regional distribution. Useful for accurately understanding the characteristics of the video audience to guide content creation, product selection, and marketing strategy optimization. Supports trend analysis across different time intervals (daily/weekly/monthly). It is suitable for tiktok workflows.
Capability
Retrieve audience profile statistics for a specified TikTok video, including gender distribution, age distribution, and regional distribution. Useful for accurately understanding the characteristics of the video audience to guide content creation, product selection, and marketing strategy optimization. Supports trend analysis across different time intervals (daily/weekly/monthly). It helps applications, agents, and automated workflows turn that capability into repeatable tasks and useful downstream experiences.
Common use cases
- Enrich profiles, accounts, and business records with structured context.
- Build media monitoring, content intelligence, and publishing-support workflows.
- Power market dashboards, alerts, comparisons, and scheduled data collection.