GET/api/v1/tiktok/audience

Audience information

Look up a TikTok creator's audience demographics by username.

Retrieve the audience composition of an indexed TikTok creator: the top audience segment and the distribution of follower age, gender, region, and device brand. A dimension without available data contributes an empty top-audience object and an empty distribution.

Each successful call costs 1 Credit. Success means HTTP 200 with code SUCCESS, including valid empty results. Failed calls and timeouts are not charged.

Parameters

usernamestringRequired

Length: 1–128 characters

TikTok username of the creator to look up. Surrounding whitespace is trimmed and one optional leading @ is removed. After normalization use 1–128 ASCII letters, digits, periods, or underscores. A profile URL is invalid.

FieldTypeDescription
code
string
data
object
profile
object
platform
string
handle
stringCanonical TikTok username of the queried creator.
profileUrl
stringTikTok profile URL of the queried creator.
audienceAnalysis
object
topAudience
objectThe single largest audience segment per dimension; an object without a segment value means that dimension has no top entry.
age
object
ageInterval
string | null
ratio
number
gender
object
gender
string | null
ratio
number
region
object
country
string | null
ratio
number
device
object
deviceBrand
string | null
ratio
number
audienceDistribution
object
ageDistribution
object[]
ageInterval
string
ratio
number
genderDistribution
object[]
gender
string
ratio
number
regionDistribution
object[]
country
string
ratio
number
deviceDistribution
object[]
deviceBrand
string
ratio
number
meta
object
request_id
stringRequest ID correlating this response.
version
string
Query parameters
IncludeKeyValue
cURL example
curl -G 'https://doapisright.com/api/v1/tiktok/audience' \  --data-urlencode 'username={username}' \  -H "Authorization: Bearer $DOAPISRIGHT_API_KEY"