Keyword audience object
The Keyword audience object has 19 fields and is returned by 1 endpoint on Douyin. A call costs $0.0020. It is a preview structure and may still change.
Keyword audience is who searches a keyword and watches content about it, by age, gender, province, city, city tier and interest. Each group has its share and a tgi: 100 is the platform's average, above 100 leans more to the word.
keyword identifies it; it comes from Douyin's trend-index (巨量算数) over the dates asked for, beside the same keyword's index history. A creator's followers are another object, Audience.
Fields
A field the platform cannot give is left out of the item and named in meta.unavailable. It is never filled with a guess or a zero.
The keyword
By age group
Name of the group, in the platform's words
Share of the audience in this group, 0 to 1
TGI: how much this group leans to the keyword; 100 is the platform's average, above 100 leans more
By gender
Name of the group, in the platform's words
Share of the audience in this group, 0 to 1
TGI: how much this group leans to the keyword; 100 is the platform's average, above 100 leans more
By province
Name of the group, in the platform's words
Share of the audience in this group, 0 to 1
TGI: how much this group leans to the keyword; 100 is the platform's average, above 100 leans more
By city: the cities with the largest shares, as the platform lists them; they do not add up to 1
Name of the group, in the platform's words
Share of the audience in this group, 0 to 1
TGI: how much this group leans to the keyword; 100 is the platform's average, above 100 leans more
By city tier
Name of the group, in the platform's words
Share of the audience in this group, 0 to 1
TGI: how much this group leans to the keyword; 100 is the platform's average, above 100 leans more
By interest; the shares do not add up to 1
Name of the group, in the platform's words
Share of the audience in this group, 0 to 1
TGI: how much this group leans to the keyword; 100 is the platform's average, above 100 leans more
Endpoints that return Keyword audience
The number beside each platform is how many of its endpoints return it.
Example
One item from douyin.index.keywords.audience.get, as recorded 2026-10-12 21:50 UTC. Names, text, IDs and links are examples; the figures are as recorded.
{
"keyword": "咖啡",
"age": [
{ "label": "18-23", "share": 0.1968, "tgi": 174.17389307762207 },
{ "label": "24-30", "share": 0.2233, "tgi": 173.71695132383041 },
// … 3 more
],
"gender": [
{ "label": "男", "share": 0.47, "tgi": 98.27023904973254 },
{ "label": "女", "share": 0.53, "tgi": 101.58569115669054 }
],
"province": [
{ "label": "北京", "share": 0.0221, "tgi": 120.01085780496312 },
{ "label": "天津", "share": 0.0121, "tgi": 105.42964416985868 },
// … 32 more
],
"city": [
{ "label": "上海", "share": 0.0245, "tgi": 125.4042968127423 },
{ "label": "广州", "share": 0.0237, "tgi": 117.79286978677968 },
// … 28 more
],
"city_tier": [
{
"label": "一线城市",
"share": 0.08856723771604946,
"tgi": 114.35574144488798
},
{
"label": "新一线城市",
"share": 0.19688659709388875,
"tgi": 103.66957853814951
},
// … 5 more
],
"interest": [
{
"label": "时尚",
"share": 0.15486799847286528,
"tgi": 111.80033780828992
},
{
"label": "美食",
"share": 0.10207902382205732,
"tgi": 113.58111661037135
},
// … 23 more
]
}