{
  "openapi": "3.0.0",
  "info": {
    "title": "抖音巨量星图分布指标 API (V1)",
    "version": "1.0.0",
    "description": "获取抖音巨量星图分发指标数据，包括曝光、传播和相关性能指标，用于创作者评估、活动规划和市场研究。"
  },
  "paths": {
    "/api/douyin-xingtu/gw/api/data_sp/get_author_spread_info/v1": {
      "get": {
        "tags": [
          "抖音巨量星图"
        ],
        "summary": "分布指标",
        "description": "获取抖音巨量星图分发指标数据，包括曝光、传播和相关性能指标，用于创作者评估、活动规划和市场研究。",
        "operationId": "gwApiDataSpGetAuthorSpreadInfoV1",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "用户鉴权令牌。",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "oAuthorId",
            "in": "query",
            "description": "作者唯一ID。",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "platform",
            "in": "query",
            "description": "平台类型。\n\n可用值：\n- `SHORT_VIDEO`: 短视频\n- `LIVE_STREAMING`: 直播\n- `PICTURE_TEXT`: 图文\n- `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": "时间范围。\n\n可用值：\n- `DAY_30`：最近 30 天\n- `DAY_90`：最近 90 天",
            "required": false,
            "schema": {
              "type": "string",
              "default": "DAY_30",
              "description": "Time range",
              "enum": [
                "DAY_30",
                "DAY_90"
              ]
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "视频类型。\n\n可用值：\n- `PERSONAL_VIDEO`: 个人视频\n- `XINTU_VIDEO`: 星图视频",
            "required": false,
            "schema": {
              "type": "string",
              "default": "PERSONAL_VIDEO",
              "description": "Author video type",
              "enum": [
                "PERSONAL_VIDEO",
                "XINTU_VIDEO"
              ]
            }
          },
          {
            "name": "onlyAssign",
            "in": "query",
            "description": "是否仅包含已分配的视频。",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "flowType",
            "in": "query",
            "description": "流程类型过滤器。\n\n可用值：\n- `EXCLUDE`：排除\n- `INCLUDE`：包含",
            "required": false,
            "schema": {
              "type": "string",
              "default": "EXCLUDE",
              "description": "Flow filter type",
              "enum": [
                "EXCLUDE",
                "INCLUDE"
              ]
            }
          }
        ],
        "responses": {
          "default": {
            "description": "默认响应",
            "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": {}
}