Douyin Keyword Index & Trend (by Keyword and Date Range)

{
  "type": "object",
  "required": [
    "end_date",
    "keyword_list",
    "start_date"
  ],
  "properties": {
    "region": {
      "type": "string",
      "description": "Region list, comma separated"
    },
    "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"
    },
    "keyword_list": {
      "type": "string",
      "description": "Keyword list, comma separated"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "keyword_index_interpretations",
    "BaseResp"
  ],
  "properties": {
    "BaseResp": {
      "type": "object",
      "properties": {
        "StatusCode": {
          "type": "number",
          "description": "0 on every fixture observed, found and not-found alike."
        },
        "StatusMessage": {
          "type": "string",
          "description": "Empty string on every fixture observed."
        }
      },
      "description": "The response envelope's own status block, present on every fixture.",
      "additionalProperties": true
    },
    "keyword_index_interpretations": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "keyword"
        ],
        "properties": {
          "keyword": {
            "type": "string",
            "description": "The keyword this row describes, echoing one of the requested keyword_list values verbatim (e.g. '咖啡')."
          },
          "overview": {
            "type": "object",
            "properties": {
              "search_index": {
                "type": "number"
              },
              "consume_index": {
                "type": "number"
              },
              "content_index": {
                "type": "number"
              }
            },
            "description": "Index figures for the requested period as NUMBERS (e.g. 908842) -- see `current_period`/`last_period`, which carry the same figures as numeric strings.",
            "additionalProperties": true
          },
          "last_period": {
            "type": "object",
            "properties": {
              "search_index": {
                "type": "string"
              },
              "consume_index": {
                "type": "string"
              },
              "content_index": {
                "type": "string"
              }
            },
            "description": "Index figures for the immediately preceding period, numeric strings like `current_period`; zeroed ('0') when no prior-period data exists.",
            "additionalProperties": true
          },
          "current_period": {
            "type": "object",
            "properties": {
              "search_index": {
                "type": "string"
              },
              "consume_index": {
                "type": "string"
              },
              "content_index": {
                "type": "string"
              }
            },
            "description": "Index figures for the current period, observed as numeric STRINGS ('908842', '0') on every fixture even though `overview` carries the same numbers -- the string typing is the shape observed, not normalized.",
            "additionalProperties": true
          },
          "last_year_diff": {
            "type": "object",
            "properties": {
              "search_diff": {
                "type": "number"
              },
              "consume_diff": {
                "type": "number"
              },
              "content_diff": {
                "type": "number"
              }
            },
            "description": "Signed fractional change versus the same period one year earlier, in [-1, infinity). -1 marks no prior-year data; a positive value like 0.8657 is the year over year growth fraction.",
            "additionalProperties": true
          },
          "last_period_diff": {
            "type": "object",
            "properties": {
              "search_diff": {
                "type": "number"
              },
              "consume_diff": {
                "type": "number"
              },
              "content_diff": {
                "type": "number"
              }
            },
            "description": "Signed fractional change versus the previous period, in [-1, infinity). The sentinel -1 means no prior-period data exists (the future-empty fixture shows -1 on every diff); other values are true changes, e.g. -0.0957 for -9.57%.",
            "additionalProperties": true
          }
        },
        "additionalProperties": true
      },
      "description": "One entry per requested keyword: a single keyword yields one element, comma-separated keywords one per keyword. Always present and populated on every fixture -- a date range with no data yet yields a zeroed element, not an empty array."
    }
  },
  "description": "The keyword-index interpretation document, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}