Douyin Search Term Heat by Keyword (1-Day or 7-Day Window)

{
  "type": "object",
  "required": [
    "keyword",
    "date_window",
    "page_num",
    "page_size"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "minLength": 1,
      "description": "The keyword to look up, in plain text; every returned search term contains it."
    },
    "page_num": {
      "enum": [
        1
      ],
      "type": "integer",
      "description": "The result page; only 1 is offered."
    },
    "page_size": {
      "enum": [
        10
      ],
      "type": "integer",
      "description": "The number of search terms returned; only 10 is offered."
    },
    "date_window": {
      "enum": [
        24,
        168
      ],
      "type": "integer",
      "description": "The score window in hours: 24 (the last day) or 168 (the last 7 days). The daily series covers up to 14 days either way."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "code": {
      "type": "number",
      "description": "0 when the lookup succeeded."
    },
    "data": {
      "type": "object",
      "properties": {
        "search_list": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "trends": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "date": {
                      "type": "string",
                      "description": "The day, as YYYYMMDD."
                    },
                    "value": {
                      "type": "number",
                      "description": "The search value for that day."
                    }
                  }
                },
                "description": "Daily search values, oldest first, up to 14 days; newer terms have fewer days."
              },
              "key_word": {
                "type": "string",
                "description": "The search term."
              },
              "search_score": {
                "type": "number",
                "description": "The term's search score for the chosen window. In testing it equalled the latest daily value for 24, and came close to the sum of the last 7 daily values for 168."
              }
            }
          },
          "description": "The first 10 matching search terms; not sorted by score."
        },
        "total_count": {
          "type": "number",
          "description": "How many search terms on the board contain the keyword."
        }
      }
    }
  },
  "description": "The matching search terms, as returned after shaping."
}