{
  "openapi": "3.0.0",
  "info": {
    "title": "Douyin Creator Marketplace (Xingtu) Distribution Metrics API (V1)",
    "version": "1.0.0",
    "description": "Get Douyin Creator Marketplace (Xingtu) distribution Metrics data, including exposure, spread, and related performance indicators, for creator evaluation, campaign planning, and marketplace research."
  },
  "paths": {
    "/api/douyin-xingtu/gw/api/data_sp/get_author_spread_info/v1": {
      "get": {
        "tags": [
          "Douyin Creator Marketplace (Xingtu)"
        ],
        "summary": "Distribution Metrics",
        "description": "Get Douyin Creator Marketplace (Xingtu) distribution Metrics data, including exposure, spread, and related performance indicators, for creator evaluation, campaign planning, and marketplace research.",
        "operationId": "gwApiDataSpGetAuthorSpreadInfoV1",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "User authentication token.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "oAuthorId",
            "in": "query",
            "description": "Author's unique ID.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "platform",
            "in": "query",
            "description": "Platform type.\n\nAvailable Values:\n- `SHORT_VIDEO`: Short video\n- `LIVE_STREAMING`: Live streaming\n- `PICTURE_TEXT`: Picture and text\n- `SHORT_DRAMA`: Short drama",
            "required": false,
            "schema": {
              "type": "string",
              "default": "SHORT_VIDEO",
              "description": "Platform type",
              "enum": [
                "SHORT_VIDEO",
                "LIVE_STREAMING",
                "PICTURE_TEXT",
                "SHORT_DRAMA"
              ]
            }
          },
          {
            "name": "range",
            "in": "query",
            "description": "Time range.\n\nAvailable Values:\n- `DAY_30`: Last 30 days\n- `DAY_90`: Last 90 days",
            "required": false,
            "schema": {
              "type": "string",
              "default": "DAY_30",
              "description": "Time range",
              "enum": [
                "DAY_30",
                "DAY_90"
              ]
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "Video type.\n\nAvailable Values:\n- `PERSONAL_VIDEO`: Personal video\n- `XINTU_VIDEO`: Xingtu video",
            "required": false,
            "schema": {
              "type": "string",
              "default": "PERSONAL_VIDEO",
              "description": "Author video type",
              "enum": [
                "PERSONAL_VIDEO",
                "XINTU_VIDEO"
              ]
            }
          },
          {
            "name": "onlyAssign",
            "in": "query",
            "description": "Whether to only include assigned videos.",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "flowType",
            "in": "query",
            "description": "Flow type filter.\n\nAvailable Values:\n- `EXCLUDE`: Exclude\n- `INCLUDE`: Include",
            "required": false,
            "schema": {
              "type": "string",
              "default": "EXCLUDE",
              "description": "Flow filter type",
              "enum": [
                "EXCLUDE",
                "INCLUDE"
              ]
            }
          }
        ],
        "responses": {
          "default": {
            "description": "default response",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "data": {
                    "avg_duration": "2600",
                    "base_resp": {
                      "status_code": 0,
                      "status_message": ""
                    },
                    "comment_avg": "4192",
                    "expect_cpe": {
                      "cpe_1_20": "253",
                      "cpe_21_60": "633",
                      "cpe_60": "633"
                    },
                    "expect_cpm": {
                      "cpm_1_20": "5618",
                      "cpm_21_60": "14043",
                      "cpm_60": "14043"
                    },
                    "interact_rate": {
                      "label": "剧情搞笑",
                      "overtake": 5973,
                      "value": 244
                    },
                    "item_num": "3",
                    "item_rate": {
                      "interact_rate": {},
                      "item_num": {
                        "label": "",
                        "overtake": 10800,
                        "value": 3
                      },
                      "play_mid": {
                        "label": "",
                        "overtake": 9993,
                        "value": 3642403
                      }
                    },
                    "like_avg": "95028",
                    "play_mid": "3642403",
                    "play_over_rate": {
                      "label": "剧情搞笑",
                      "overtake": 6400,
                      "value": 1113
                    },
                    "play_stability": {
                      "label": "剧情搞笑",
                      "overtake": 8865,
                      "value": 540887
                    },
                    "sales_expect_cpm": {
                      "cpm_1_20": "6619",
                      "cpm_21_60": "16543",
                      "cpm_60": "16543"
                    },
                    "share_avg": "9637"
                  }
                }
              }
            }
          }
        },
        "x-order": "15001900"
      }
    }
  },
  "components": {}
}