TikTok Search Topic Audience, Past 30 Days

{
  "type": "object",
  "required": [
    "query_id_str"
  ],
  "properties": {
    "time_range": {
      "enum": [
        "past_30_days"
      ],
      "type": "string",
      "description": "Optional. Only \"past_30_days\", the default; other windows are not offered."
    },
    "query_id_str": {
      "type": "string",
      "description": "The search topic's query id, a string of digits, as listed for each topic by TikTok Creator Search Insights (the TikTok Trending Topics for Creators tool returns it)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "age": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "category": {
            "type": "string",
            "description": "The age group, or \"total\" / \"others\"."
          },
          "popularity": {
            "type": "number",
            "description": "The search popularity for that group."
          }
        }
      },
      "description": "One row per age group, plus a \"total\" row and an \"others\" row for unattributed searches."
    },
    "location": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "category": {
            "type": "string",
            "description": "The country name, or \"total\"."
          },
          "popularity": {
            "type": "number",
            "description": "The search popularity for that country."
          }
        }
      },
      "description": "The leading countries (five in the captures) plus a \"total\" row covering all countries."
    },
    "status_msg": {
      "type": "string"
    },
    "status_code": {
      "type": "number",
      "description": "0 on success."
    },
    "demographics": {
      "type": "object",
      "properties": {
        "age": {
          "type": "string",
          "description": "The largest age group."
        },
        "location": {
          "type": "string",
          "description": "The largest country."
        }
      },
      "description": "The largest group in each breakdown."
    }
  },
  "description": "The topic's audience breakdown, as returned after shaping."
}