{ "openapi": "3.0.0", "info": { "title": "抖音热搜 API (V1)", "version": "1.0.0", "description": "获取抖音热门内容搜索数据，包括排名内容项、创作者信号、互动指标、丰富的视频元数据和分页信息，用于趋势发现、内容研究和活动策划。" }, "servers": [ { "url": "https://api.justoneapi.com", "description": "prod-global（默认）" }, { "url": "http://47.117.133.51:30015", "description": "prod-cn（中国大陆地区可选）" } ], "paths": { "/api/douyin/hot-search/v1": { "get": { "tags": [ "抖音" ], "summary": "热搜", "description": "获取抖音热门内容搜索数据，包括排名内容项、创作者信号、互动指标、丰富的视频元数据和分页信息，用于趋势发现、内容研究和活动策划。", "operationId": "getApiDouyinHotSearchV1", "parameters": [ { "name": "token", "in": "query", "description": "此 API 服务的访问令牌。", "required": true, "schema": { "type": "string" } }, { "name": "keyword", "in": "query", "description": "可选的搜索关键词。", "required": false, "schema": { "type": "string" } }, { "name": "contentType", "in": "query", "description": "顶级内容类型。只能选择一种内容类型。\n\n可选值：\n- `ALL`：所有内容类型。\n- `FASHION`：时尚。\n- `TECHNOLOGY`：科技。\n- `SCIENCE`：科学。\n- `PHOTOGRAPHY`：摄影与摄像。\n- `FOOD`：美食。\n- `MOTHER_BABY`：母婴。\n- `PARENTING`：育儿。\n- `DRAMA`：戏剧。\n- `GAME`：游戏。\n- `AUTOMOTIVE`：汽车。\n- `ANIMAL`：动物。\n- `TRAVEL`：旅行。\n- `DANCE`：舞蹈。\n- `TRADITIONAL_CULTURE`：传统文化。\n- `ART`：艺术。\n- `SPORTS`：体育。\n- `MUSIC`：音乐。\n- `LIFE_RECORD`：生活记录。\n- `HOME_LIVING`：家居生活。\n- `LEISURE_ENTERTAINMENT`：休闲娱乐。\n- `WORKPLACE`：职场。\n- `AGRICULTURE`：农业。\n- `CASUAL`：随拍。\n- `ACG`：动漫、漫画与游戏。\n- `MOVIE`：电影。\n- `TV_SERIES`：电视剧。\n- `VARIETY_SHOW`：综艺。\n- `CELEBRITY`：明星。\n- `HUMANITIES_SOCIAL_SCIENCE`：人文社科。\n- `EDUCATION_CAMPUS`：教育校园。\n- `EMOTION`：情感。\n- `FINANCE`：财经。\n- `PUBLIC_WELFARE`：公益。", "required": false, "schema": { "type": "string", "default": "ALL", "description": "Douyin Hot Search content type.", "enum": [ "ALL", "FASHION", "TECHNOLOGY", "SCIENCE", "PHOTOGRAPHY", "FOOD", "MOTHER_BABY", "PARENTING", "DRAMA", "GAME", "AUTOMOTIVE", "ANIMAL", "TRAVEL", "DANCE", "TRADITIONAL_CULTURE", "ART", "SPORTS", "MUSIC", "LIFE_RECORD", "HOME_LIVING", "LEISURE_ENTERTAINMENT", "WORKPLACE", "AGRICULTURE", "CASUAL", "ACG", "MOVIE", "TV_SERIES", "VARIETY_SHOW", "CELEBRITY", "HUMANITIES_SOCIAL_SCIENCE", "EDUCATION_CAMPUS", "EMOTION", "FINANCE", "PUBLIC_WELFARE" ] } }, { "name": "videoType", "in": "query", "description": "视频类型筛选。\n\n可选值：\n- `ALL`：所有视频类型。\n- `XINGTU_VIDEO`：星图商业视频。\n- `NATURAL_VIDEO`：自然视频。", "required": false, "schema": { "type": "string", "default": "ALL", "description": "Douyin Hot Search video type.", "enum": [ "ALL", "XINGTU_VIDEO", "NATURAL_VIDEO" ] } }, { "name": "sortType", "in": "query", "description": "热门内容结果的排序标准。\n\n可选值：\n- `COMPREHENSIVE`：综合排序。\n- `HIGH_INTERACTION`：最高互动量。\n- `HIGH_LIKE`：最高点赞量。\n- `HIGH_COMMENT`：最高评论量。\n- `HIGH_SHARE`：最高分享量。", "required": false, "schema": { "type": "string", "default": "COMPREHENSIVE", "description": "Douyin Hot Search sort type.", "enum": [ "COMPREHENSIVE", "HIGH_INTERACTION", "HIGH_LIKE", "HIGH_COMMENT", "HIGH_SHARE" ] } }, { "name": "page", "in": "query", "description": "页码（从1开始）。每页固定10条。", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "likeCountMin", "in": "query", "description": "最低原始点赞数。", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "likeCountMax", "in": "query", "description": "最高原始点赞数。", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "commentCountMin", "in": "query", "description": "最低原始评论数。", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "commentCountMax", "in": "query", "description": "最高原始评论数。", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "shareCountMin", "in": "query", "description": "最低原始分享数。", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "shareCountMax", "in": "query", "description": "最高原始分享数。", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "interactionCountMin", "in": "query", "description": "最低原始互动数。", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "interactionCountMax", "in": "query", "description": "最高原始互动数。", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "followerCountMin", "in": "query", "description": "最低原始创作者粉丝数。", "required": false, "schema": { "type": "integer", "format": "int64" } }, { "name": "followerCountMax", "in": "query", "description": "最高原始创作者粉丝数。", "required": false, "schema": { "type": "integer", "format": "int64" } } ], "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": "14001050", "x-api-version": "v1", "x-highlights": [] } } }, "components": {} }