Douyin Single-Video Audience Profile (by Video ID and Date Range)

{
  "type": "object",
  "required": [
    "item_id",
    "start_date",
    "end_date"
  ],
  "properties": {
    "item_id": {
      "type": "string",
      "pattern": "^[0-9]+$",
      "description": "The Douyin video's numeric id (its aweme id), as a string of digits."
    },
    "end_date": {
      "type": "string",
      "pattern": "^[0-9]{8}$",
      "description": "The last day of the window, as YYYYMMDD."
    },
    "start_date": {
      "type": "string",
      "pattern": "^[0-9]{8}$",
      "description": "The first day of the window, as YYYYMMDD."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name_en": {
            "type": "string",
            "description": "The dimension's English key."
          },
          "name_zh": {
            "type": "string",
            "description": "The dimension's Chinese label."
          },
          "label_list": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "tgi": {
                  "type": "number",
                  "description": "The bucket's index against the platform baseline (100 is average)."
                },
                "value": {
                  "type": "number",
                  "description": "The bucket's share of the audience, 0 to 1. On the province_city dimension, the city's share within its province."
                },
                "name_zh": {
                  "type": "string",
                  "description": "The bucket's Chinese label (an age band, a gender, a place, a city tier or an interest)."
                },
                "child_list": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "tgi": {
                        "type": "number",
                        "description": "The sub-category's index against the platform baseline."
                      },
                      "value": {
                        "type": "number",
                        "description": "The sub-category's share of the audience, 0 to 1."
                      },
                      "name_zh": {
                        "type": "string",
                        "description": "The sub-category's label."
                      }
                    }
                  },
                  "description": "On the interest dimension only: the interest's sub-categories."
                },
                "parent_name": {
                  "type": "string",
                  "description": "On the province_city dimension only: the province or region the city belongs to."
                }
              }
            },
            "description": "One entry per bucket of the dimension."
          }
        }
      },
      "description": "One entry per audience dimension: age, gender, province, city, city tier (yuntu_city_level), interest category, and province_city."
    },
    "BaseResp": {
      "type": "object",
      "properties": {
        "StatusCode": {
          "type": "number",
          "description": "0 on success."
        },
        "StatusMessage": {
          "type": "string"
        }
      },
      "description": "The request status."
    }
  },
  "description": "One video's audience profile, as returned after shaping."
}