{
  "openapi": "3.0.0",
  "info": {
    "title": "抖音巨量星图创作者主页视频 API (V1)",
    "version": "1.0.0",
    "description": "获取抖音巨量星图创作者主页视频列表数据，包括标题、视频ID、播放量、互动量、发布时间和内容主题标签，用于内容分析。"
  },
  "servers": [
    {
      "url": "https://api.justoneapi.com",
      "description": "prod-global（默认）"
    },
    {
      "url": "http://47.117.133.51:30015",
      "description": "prod-cn（中国大陆地区可选）"
    }
  ],
  "paths": {
    "/api/douyin-xingtu/gw/api/aggregator/get_author_homepage_videos/v1": {
      "get": {
        "tags": [
          "抖音巨量星图"
        ],
        "summary": "创作者主页视频",
        "description": "获取抖音巨量星图创作者主页视频列表数据，包括标题、视频ID、播放量、互动量、发布时间和内容主题标签，用于内容分析。",
        "operationId": "getApiDouyinXingtuGwApiAggregatorGetAuthorHomepageVideosV1",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "用户鉴权令牌。",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "oAuthorId",
            "in": "query",
            "description": "作者在巨量星图的唯一ID。",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "页码，从1开始。",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "description": "用于搜索创作者主页视频的关键词。",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "videoType",
            "in": "query",
            "description": "主页视频类型筛选。\n\n可选值：\n- `ALL`：所有视频\n- `PERSONAL`：个人视频\n- `XINGTU`：巨量星图视频",
            "required": false,
            "schema": {
              "type": "string",
              "default": "ALL",
              "description": "Creator homepage video type",
              "enum": [
                "ALL",
                "PERSONAL",
                "XINGTU"
              ]
            }
          },
          {
            "name": "onlyAssign",
            "in": "query",
            "description": "是否仅包含已分配的视频。当`videoType`为`XINGTU`时，星图通常显示此选项。",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false,
              "example": true
            }
          },
          {
            "name": "startDate",
            "in": "query",
            "description": "开始发布日期，格式为yyyyMMdd。筛选从北京时间00:00:00开始。",
            "required": false,
            "schema": {
              "type": "string",
              "example": 20260702
            }
          },
          {
            "name": "endDate",
            "in": "query",
            "description": "结束发布日期，格式为yyyyMMdd。筛选至北京时间23:59:59结束。",
            "required": false,
            "schema": {
              "type": "string",
              "example": 20260702
            }
          }
        ],
        "responses": {
          "200": {
            "description": "好的",
            "content": {
              "*/*": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "enum": [
                        "0",
                        "100",
                        "101",
                        "202",
                        "300",
                        "301",
                        "302",
                        "303",
                        "400",
                        "404",
                        "500",
                        "600",
                        "601",
                        "602"
                      ]
                    },
                    "message": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object"
                    },
                    "recordTime": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "requestId": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-order": "15003082",
        "x-api-version": "v1",
        "x-highlights": []
      }
    }
  },
  "components": {}
}