API referenceTikTok
TikTok user audience
Demographics sample (by location) for a creator's audience.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/tiktok-user-audience-v4" \ -H "Content-Type: application/json" \ -d '{ "username": "tiktok" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "audienceLocations": [ { "count": 45, "country": "Thailand", "countryCode": "TH", "percentage": "18.00%" }, { "count": 28, "country": "Pakistan", "countryCode": "PK", "percentage": "11.20%" }, "… 58 more items in the full response" ], "success": true }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "tiktok-user-audience-v4", "billable": true, "duration_ms": 2805 }}