TikTok Video Audience Stats
https://api.sandbase.ai/v1/api/tiktok/creator/video-audience-statsReturns audience profile statistics for a TikTok video by ID, covering gender, age, and regional breakdowns. Supports filtering starting from an optional date.
- Price
- $0.0015USD / callFirst 100 calls per day free (shared per organization)
- Method
- POST
- Response
- JSON
- Parameters
- 1 required · 2 optional
Try the model
Playground
Your output will appear here
Complete the inputs, then click Run.
Model card
Specifications
Pricing
- Base price
- $0.0015 / run
- Daily free calls
- First 100 calls per day free (shared per organization)
Request & response
- Method
- POST
- Request body
- application/json
- Response
- application/json
- Execution
- sync
Parameters
- item_id
- string · required
- proxy
- any · optional
- start_date
- string · optional
Access
- Provider
- TikTok
- API
- Platform API
- Base URL
- https://api.sandbase.ai
- Endpoint
- /v1/api/tiktok/creator/video-audience-stats
- Authentication
- Bearer API key
API README
TikTok Video Audience Stats API
Provide a video ID via item_id to retrieve audience demographics such as gender, age, and location distribution. Use start_date to set the beginning of the reporting timeframe.
Use cases
- Analyze audience demographics for specific TikTok videos.
- Evaluate viewer geographic distribution for marketing campaigns.
- Assess age and gender metrics to guide content strategy.
Request
curl -X POST "https://api.sandbase.ai/v1/api/tiktok/creator/video-audience-stats" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"item_id": "7350810998023949599"}'
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
item_id | string | Yes | Video ID |
proxy | string | No | Optional HTTP Proxy Address |
start_date | string | No | Query Start Date, e.g. '04-01-2025' |
Notes
- Supply the target video ID in
item_id. - Filter the start of the query window using
start_datewith formats such as '04-01-2025'.
Related APIs
- TikTok Creator Account Health Status: Returns the health status of a TikTok Shop creator account.
- TikTok Creator Account Insights Overview: Retrieves performance metrics for a TikTok Shop creator account, including revenue, exposure, clicks, and orders for the specified month.
- TikTok Creator Account Violations: Returns the violation history and enforcement actions for a TikTok Shop creator account.
Start building
Send your first request
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/tiktok/creator/video-audience-stats" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"item_id": "7350810998023949599"
}
SANDBASE_JSON
)
printf '%s\n' "$result"Explore more
Related APIs
| API | Price | Response | Released |
|---|---|---|---|
TikTok Video Audience StatsThis API TikTok | $0.0015 per call | JSON | Jul 31, 2026 |
TikTok | $0.0015 per call | JSON | Jul 31, 2026 |
TikTok | $0.0015 per call | JSON | Jul 31, 2026 |
TikTok | $0.0015 per call | JSON | Jul 31, 2026 |
TikTok | $0.0015 per call | JSON | Jul 31, 2026 |
TikTok | $0.0015 per call | JSON | Jul 31, 2026 |
Questions
FAQ
How do I use the TikTok Video Audience Stats API?
Send a POST request to https://api.sandbase.ai/v1/api/tiktok/creator/video-audience-stats with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
How much does the TikTok Video Audience Stats API cost?
$0.0015 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.
What parameters does the TikTok Video Audience Stats API accept?
Required: item_id (string). Optional: proxy (any) and start_date (string). The Parameters table and the Playground on this page list every field.
What does the TikTok Video Audience Stats API return?
A JSON response returned in the same HTTP request (synchronous).
Do I need a TikTok developer account or API key?
No. TikTok Video Audience Stats runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for TikTok API access separately.