Douyin Audience Portrait (by Keyword and Date Range)

{
  "type": "object",
  "required": [
    "end_date",
    "keyword",
    "start_date"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "description": "Keyword"
    },
    "app_name": {
      "enum": [
        "aweme",
        "toutiao"
      ],
      "type": "string",
      "default": "aweme",
      "description": "平台/Platform: aweme(抖音), toutiao(头条)"
    },
    "end_date": {
      "type": "string",
      "description": "End date YYYYMMDD"
    },
    "start_date": {
      "type": "string",
      "description": "Start date YYYYMMDD"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name_en": {
            "type": "string",
            "description": "The dimension's English key (e.g. age, gender, province, city, province_city, yuntu_city_level, or an interest-category key)."
          },
          "name_zh": {
            "type": "string",
            "description": "The dimension's Chinese label (e.g. 年龄/age, 性别/gender)."
          },
          "label_list": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "tgi": {
                  "type": "number",
                  "description": "The bucket's index against the platform baseline audience (100 = average; observed 0 alongside `value` 0 on negligible buckets)."
                },
                "value": {
                  "type": "number",
                  "description": "The bucket's share of the audience, 0-1 (observed 0 for negligible buckets such as 台湾 on the province dimension)."
                },
                "name_zh": {
                  "type": "string",
                  "description": "The bucket's Chinese label (e.g. 18-23, 男, 北京)."
                },
                "label_id": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "An internal category id assigned by the source. Always `null` in this tool's output -- the value is withheld (see verification.notes); only its presence as a field is observable."
                },
                "child_list": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "tgi": {
                        "type": "number",
                        "description": "The sub-bucket's index against the platform baseline audience."
                      },
                      "value": {
                        "type": "number",
                        "description": "The sub-bucket's share of the audience, 0-1 (observed 0 for negligible sub-buckets)."
                      },
                      "name_zh": {
                        "type": "string",
                        "description": "The sub-bucket's Chinese label (e.g. 时尚_穿搭)."
                      },
                      "label_id": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "An internal sub-category id. Always `null` in this tool's output -- the value is withheld (see verification.notes)."
                      }
                    },
                    "additionalProperties": true
                  },
                  "description": "Only on the interest-category dimension of the Douyin (aweme) platform: nested sub-labels (e.g. 时尚_穿搭 under 时尚). Absent entirely on the Toutiao platform fixture."
                },
                "parent_name": {
                  "type": "string",
                  "description": "Only on the province_city dimension: the province/region a city entry belongs to (e.g. 广东 for 深圳). Absent on every other dimension."
                }
              },
              "additionalProperties": true
            },
            "description": "One entry per bucket within this dimension (an age range, a gender, a province, a city, a city tier, or an interest category)."
          }
        },
        "additionalProperties": true
      },
      "description": "One entry per audience dimension -- the set varies by platform but always includes age, gender, province, city, city-tier, province_city and an interest category dimension."
    },
    "BaseResp": {
      "type": "object",
      "properties": {
        "StatusCode": {
          "type": "number",
          "description": "0 on success on both calibration fixtures; a nonzero value would indicate an upstream error."
        },
        "StatusMessage": {
          "type": "string",
          "description": "Empty on success on both calibration fixtures; carries error text when StatusCode is nonzero."
        }
      },
      "description": "The request's status envelope.",
      "additionalProperties": true
    }
  },
  "description": "One Douyin (or Toutiao) audience portrait, as returned at routing.responseResultPath ($.output): a `data` array of audience dimensions plus a `BaseResp` request-status envelope.",
  "additionalProperties": true
}