{ "openapi": "3.1.0", "info": { "title": "抖音视频搜索 API (V1)", "version": "v0", "description": "通过移动应用流程搜索抖音视频。从关键词和可选过滤条件开始。后续只使用前次响应中的 data.business_config.next_page.search_id 继续；分页状态最多保留 24 小时。" }, "servers": [ { "url": "https://api.justoneapi.com", "description": "全球生产 API（默认）" }, { "url": "http://47.117.133.51:30015", "description": "中国大陆生产 API（可选）" } ], "tags": [ { "name": "抖音", "description": "抖音用户、视频、评论和搜索数据，用于内容情报、账号监控和发现。", "x-platform-id": "douyin-tiktok-china", "x-platform-aliases": [ "Douyin", "TikTok China", "抖音" ], "x-platform-detection-aliases": [ "Douyin", "TikTok China", "抖音" ] } ], "paths": { "/api/douyin/search-video/v1": { "get": { "tags": [ "抖音" ], "summary": "视频搜索", "description": "通过移动应用流程搜索抖音视频。从关键词和可选过滤条件开始。后续只使用前次响应中的 data.business_config.next_page.search_id 继续；分页状态最多保留 24 小时。", "operationId": "getApiDouyinSearchVideoV1", "parameters": [ { "name": "token", "in": "query", "description": "此 API 服务的访问令牌。", "required": true, "schema": { "type": "string" } }, { "name": "keyword", "in": "query", "description": "搜索关键词。开始新搜索时必需；使用 searchId 继续搜索时省略。", "required": false, "schema": { "type": "string" } }, { "name": "sortType", "in": "query", "description": "新搜索的排序条件。继续搜索时会重用已存储的设置。\n\n可选值：\n- `_0`：综合\n- `_1`：最多点赞\n- `_2`：最新\n- `_3`：最多评论\n- `_4`：最多收藏", "required": false, "schema": { "type": "string", "default": "_0", "description": "抖音 App - 视频搜索排序类型", "enum": [ "_0", "_1", "_2", "_3", "_4" ] } }, { "name": "publishTime", "in": "query", "description": "新搜索的发布时间筛选条件。继续搜索时会重用已存储的设置。\n\n可选值：\n- `_0`：不限\n- `_1`：最近24小时\n- `_7`：最近7天\n- `_180`：最近6个月", "required": false, "schema": { "type": "string", "default": "_0", "description": "按视频发布时间范围筛选。", "enum": [ "_0", "_1", "_7", "_180" ] } }, { "name": "duration", "in": "query", "description": "新搜索的时长筛选条件。继续搜索时会重用已存储的设置。\n\n可选值：\n- `_0`：不限\n- `_1`：1分钟以内\n- `_2`：1-5分钟\n- `_3`：5分钟以上", "required": false, "schema": { "type": "string", "default": "_0", "description": "按视频时长筛选。", "enum": [ "_0", "_1", "_2", "_3" ] } }, { "name": "searchId", "in": "query", "description": "仅用于继续搜索。使用前次响应中的 data.business_config.next_page.search_id。存储的分页状态在 24 小时后过期。", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "好的", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "400": { "description": "请求参数或请求体无效", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "401": { "description": "访问令牌无效或未激活", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "403": { "description": "权限不足", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "429": { "description": "请求速率或每日配额已超限", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "500": { "description": "服务器内部错误", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } } }, "x-order": "14000900", "x-api-version": "v1", "x-search-aliases": [ "Douyin App video search API", "Douyin keyword video search", "Douyin search session pagination", "抖音 App 视频搜索接口", "抖音关键词搜视频", "抖音搜索会话翻页" ], "x-highlights": [], "x-docs-hidden": true, "x-endpoint-family": "douyin_search_video" } } } }