KeywordAudience object

Who searches for or reads about a keyword, by age, gender, place and interest. The same fields on every platform. A field a platform does not show is null, and meta.unavailable names it with the reason.

Field	Type	From view	Description
`keyword`	string	compact	The keyword.
`age`	KeywordSegment[] \| null	compact	By age group.
`gender`	KeywordSegment[] \| null	compact	By gender.
`province`	KeywordSegment[] \| null	compact	By province.
`city`	KeywordSegment[] \| null	compact	By city: the largest only, so the shares need not add up to 1.
`city_tier`	KeywordSegment[] \| null	compact	By city tier.
`interest`	KeywordSegment[] \| null	compact	By interest; the shares need not add up to 1.
`ext`	object	full	Platform-specific extras. Only returned with view=full. · only with view=full

KeywordSegment

Field	Type	Description
`label`	string	The group, in the platform's words.
`share`	number \| null	The group's share of the keyword's audience, 0 to 1.
`tgi`	number \| null	TGI: how strongly the group leans to the keyword; 100 is the platform average.

Example · douyin

{
  "keyword": null,
  "age": [
    {
      "label": null,
      "share": null,
      "tgi": null
    }
  ],
  "gender": [
    {
      "label": null,
      "share": null,
      "tgi": null
    }
  ],
  "province": [
    {
      "label": null,
      "share": null,
      "tgi": null
    }
  ],
  "city": [
    {
      "label": null,
      "share": null,
      "tgi": null
    }
  ],
  "city_tier": [
    {
      "label": null,
      "share": null,
      "tgi": null
    }
  ],
  "interest": [
    {
      "label": null,
      "share": null,
      "tgi": null
    }
  ]
}

Endpoints that return a KeywordAudience

Douyin index: keyword audiencedouyin.index.keywords.audience.getKeywordAudience$0.002/call

Connect once, then just ask.

Every new key comes with $0.10 to try it. One sentence connects your agent.

Start free

Connect your AI

Paste this into your agent

Read https://okdata.online/agents.md and set up okdata for me; my key is in the OKDATA_API_KEY environment variable.

Step-by-step for each app

Claude Code, Cursor, Codex and other agents that can open a link set themselves up from it.

MCP serverhttps://api.okdata.online/mcp