# 搜索-搜索直播 `POST /api/douyin-app/search_live` - 按抖音号或抖音昵称搜索直播间，支持游标翻页。 - 适合定位某个主播的直播间，而不是按内容关键词泛搜直播。 - keyword 匹配的是主播的抖音号或昵称，传入内容类关键词（如 "游戏"）通常匹配不到结果。 - 本接口不支持排序、发布时间、时长等筛选条件。 - 每页固定 10 条，不支持指定数量。 - 首次请求 cursor 传 0，翻页时传上一页响应里返回的 cursor。 ## 鉴权 源接口未声明鉴权要求，请结合接入指南确认。 ## 请求参数 | 字段 | 位置 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | --- | | Authorization | header | string | 是 | 在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 apikey · default: "Bearer YOUR_API_KEY" | | Content-Type | header | string | 是 | · default: "application/json" | ## 请求体 · application/json | 字段 | 位置 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | --- | | keyword | body | string | 是 | 抖音号 或 抖音昵称（必填） | | cursor | body | string | 是 | 首次请求传 0，翻页时使用上次响应的 cursor · default: "0" | ```json { "type" : "object", "properties" : { "keyword" : { "type" : "string", "title" : "关键词", "description" : "抖音号 或 抖音昵称（必填）" }, "cursor" : { "type" : "string", "description" : "首次请求传 0，翻页时使用上次响应的 cursor", "default" : "0", "title" : "翻页参数" } }, "required" : [ "keyword", "cursor" ] } ``` ```json { "keyword" : "罗永浩", "cursor" : 0 } ``` ## 响应 200 · application/json | 字段 | 位置 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | --- | | code | body | integer | 是 | | | message | body | string | 是 | | | data | body | object | 是 | | ```json { "type" : "object", "properties" : { "code" : { "type" : "integer" }, "message" : { "type" : "string" }, "data" : { "type" : "object", "properties" : { } } }, "required" : [ "code", "message", "data" ] } ``` ```json { "code" : 200, "message" : "success", "data" : { "code" : 0, "msg" : "success", "data" : { "cursor" : 10, "userList" : [ { "avatar" : "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_326685675806f8e08b44e25e0b9dc3b5.jpeg?from=2956013662", "nickname" : "罗永浩的十字路口", "followerCount" : 2257669, "uniqueId" : "luoyonghao", "shortId" : "48180113940", "secUid" : "MS4wLjABAAAAdYnizw-yHaCBKEeZugZp-kWwLCjvB8GW-iR0I3BdxmkdyKxQkCODEKwzMTvYQgB0", "followerCountStr" : "", "liveRoomInfo" : { "LiveRoomLiveStatus" : 0, "LiveRoomInfoDetail" : { "RoomId" : "0", "LiveRoomCoverUri" : "aweme-avatar/tos-cn-avt-0015_326685675806f8e08b44e25e0b9dc3b5", "Title" : "", "AnchorNickname" : "罗永浩的十字路口" }, "LiveRoomInfoExtra" : { "HasClosedShoppingCart" : false, "HasWindmill" : false, "HasBisinessComponent" : false, "IsForO2ORoom" : false } } }, { "avatar" : "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_f446b7451ce31af830724e04e10d7cb2.jpeg?from=2956013662", "nickname" : "交个朋友直播间", "followerCount" : 24646540, "uniqueId" : "JGPYZBJ", "shortId" : "3601031925", "secUid" : "MS4wLjABAAAAlwXCzzm7SmBfdZAsqQ_wVVUbpTvUSX1WC_x8HAjMa3gLb88-MwKL7s4OqlYntX4r", "followerCountStr" : "", "liveRoomInfo" : { "LiveRoomLiveStatus" : 1, "LiveRoomInfoDetail" : { "RoomId" : "7706127274895624960", "LiveRoomCoverUri" : "/webcast/1794222579167-4195355415549012-642b96c5cc3986709a36254262024f28.png", "Title" : "双十一电脑破价，三方加补，早买早享受！", "AnchorNickname" : "交个朋友直播间" }, "LiveRoomInfoExtra" : { "HasClosedShoppingCart" : true, "HasWindmill" : false, "HasBisinessComponent" : false, "IsForO2ORoom" : false } } }, { "avatar" : "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813_oIqyqqVfEv8kAFRAxACEAgASRbAMCRDsAIpf9h.jpeg?from=2956013662", "nickname" : "罗永浩的宝藏铺子（东娱分铺）", "followerCount" : 140510, "uniqueId" : "dyphdyph", "shortId" : "39272403789", "secUid" : "MS4wLjABAAAA4UT2CHsG2QupXZQmu34dW8G2YJXd2D_fxYGL8viwUdCAgpcyGQvZI7vtfPOomdEA", "followerCountStr" : "", "liveRoomInfo" : { "LiveRoomLiveStatus" : 0, "LiveRoomInfoDetail" : { "RoomId" : "0", "LiveRoomCoverUri" : "aweme-avatar/tos-cn-i-0813_oIqyqqVfEv8kAFRAxACEAgASRbAMCRDsAIpf9h", "Title" : "", "AnchorNickname" : "罗永浩的宝藏铺子（东娱分铺）" }, "LiveRoomInfoExtra" : { "HasClosedShoppingCart" : false, "HasWindmill" : false, "HasBisinessComponent" : false, "IsForO2ORoom" : false } } }, { "avatar" : "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_8b920d330e40f54e006cb1d07fa1c0ad.jpeg?from=2956013662", "nickname" : "老罗-直播福利", "followerCount" : 81134, "uniqueId" : "56721055588", "shortId" : "56721055588", "secUid" : "MS4wLjABAAAArQPSx7bBesuqOwIPqDcSP6vhjTCz-GCCnXChXOwtzFg", "followerCountStr" : "", "liveRoomInfo" : { "LiveRoomLiveStatus" : 0, "LiveRoomInfoDetail" : { "RoomId" : "0", "LiveRoomCoverUri" : "aweme-avatar/tos-cn-avt-0015_8b920d330e40f54e006cb1d07fa1c0ad", "Title" : "", "AnchorNickname" : "老罗-直播福利" }, "LiveRoomInfoExtra" : { "HasClosedShoppingCart" : false, "HasWindmill" : false, "HasBisinessComponent" : false, "IsForO2ORoom" : false } } }, { "avatar" : "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_5466a5f3add77a5a9237b5b232c3cc76.jpeg?from=2956013662", "nickname" : "交朋友-老罗直播【福利返场】", "followerCount" : 30112, "uniqueId" : "78877146166", "shortId" : "78877146166", "secUid" : "MS4wLjABAAAAwuvQhSOBt7jX2S4luyUa0lzxdu_DCb2LEgWPVXudp5U", "followerCountStr" : "", "liveRoomInfo" : { "LiveRoomLiveStatus" : 0, "LiveRoomInfoDetail" : { "RoomId" : "0", "LiveRoomCoverUri" : "aweme-avatar/tos-cn-avt-0015_5466a5f3add77a5a9237b5b232c3cc76", "Title" : "", "AnchorNickname" : "交朋友-老罗直播【福利返场】" }, "LiveRoomInfoExtra" : { "HasClosedShoppingCart" : false, "HasWindmill" : false, "HasBisinessComponent" : false, "IsForO2ORoom" : false } } }, { "avatar" : "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_8b16476c92df7f79f304f5fb1be21c60.jpeg?from=2956013662", "nickname" : "KOBACH康巴赫官方旗舰店", "followerCount" : 406403, "uniqueId" : "66399423959", "shortId" : "66399423959", "secUid" : "MS4wLjABAAAAbGtkaTS4J4wc_FFNOsRi4F-TRXnfhHnC-QVdypZ8bIm1_4vGs1z5PH5HcngrYl3e", "followerCountStr" : "", "liveRoomInfo" : { "LiveRoomLiveStatus" : 1, "LiveRoomInfoDetail" : { "RoomId" : "7705923777795853099", "LiveRoomCoverUri" : "webcast-cover/7575322462286252851", "Title" : "双11抢先购限时福利专场！！！", "AnchorNickname" : "KOBACH康巴赫官方旗舰店" }, "LiveRoomInfoExtra" : { "HasClosedShoppingCart" : true, "HasWindmill" : false, "HasBisinessComponent" : false, "IsForO2ORoom" : false } } }, { "avatar" : "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813_21966525432c4e3799ce3a21c83a3c0e.jpeg?from=2956013662", "nickname" : "罗永浩", "followerCount" : 1729, "uniqueId" : "dy1xmnwdwpim", "shortId" : "2352998400", "secUid" : "MS4wLjABAAAAYLAGwO3BTu744BENJRv00iMsk44R6WoLJmj85ErJnQHF1vV8X-XkitRLwPaXpkyY", "followerCountStr" : "", "liveRoomInfo" : { "LiveRoomLiveStatus" : 0, "LiveRoomInfoDetail" : { "RoomId" : "0", "LiveRoomCoverUri" : "aweme-avatar/tos-cn-i-0813_21966525432c4e3799ce3a21c83a3c0e", "Title" : "", "AnchorNickname" : "罗永浩" }, "LiveRoomInfoExtra" : { "HasClosedShoppingCart" : false, "HasWindmill" : false, "HasBisinessComponent" : false, "IsForO2ORoom" : false } } }, { "avatar" : "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_a35043657c46a5c4742af5d0054b87b5.jpeg?from=2956013662", "nickname" : "罗永浩 好物官", "followerCount" : 1271, "uniqueId" : "55446519849", "shortId" : "55446519849", "secUid" : "MS4wLjABAAAAWIkJ5b6BsnaDD-x5OdoBukR6vWkPDZH9-JnGQWh3xHs", "followerCountStr" : "", "liveRoomInfo" : { "LiveRoomLiveStatus" : 0, "LiveRoomInfoDetail" : { "RoomId" : "0", "LiveRoomCoverUri" : "aweme-avatar/tos-cn-avt-0015_a35043657c46a5c4742af5d0054b87b5", "Title" : "", "AnchorNickname" : "罗永浩 好物官" }, "LiveRoomInfoExtra" : { "HasClosedShoppingCart" : false, "HasWindmill" : false, "HasBisinessComponent" : false, "IsForO2ORoom" : false } } }, { "avatar" : "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813c001_d15de2510e6540f6b9a82e6d7b91372b.jpeg?from=2956013662", "nickname" : "罗永浩好货小铺子", "followerCount" : 5221, "uniqueId" : "181977820", "shortId" : "181977820", "secUid" : "MS4wLjABAAAARMCbhptuyPYyN2NQWrKB49uLzdN3KENRfrgp0ud1Re8", "followerCountStr" : "", "liveRoomInfo" : { "LiveRoomLiveStatus" : 0, "LiveRoomInfoDetail" : { "RoomId" : "0", "LiveRoomCoverUri" : "aweme-avatar/tos-cn-i-0813c001_d15de2510e6540f6b9a82e6d7b91372b", "Title" : "", "AnchorNickname" : "罗永浩好货小铺子" }, "LiveRoomInfoExtra" : { "HasClosedShoppingCart" : false, "HasWindmill" : false, "HasBisinessComponent" : false, "IsForO2ORoom" : false } } }, { "avatar" : "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-c9aec8xkvj_f55f52e1c94e48138b491f5a9c8689e2.jpeg?from=2956013662", "nickname" : "罗永浩直播好物分享", "followerCount" : 1084, "uniqueId" : "53317958422", "shortId" : "53317958422", "secUid" : "MS4wLjABAAAA77TQAe7qmZGWTtWyLdlifkKZoOIZuGd4jI3-tM1rr58NXIR3ktzjfs6Eu2tTl6zK", "followerCountStr" : "", "liveRoomInfo" : { "LiveRoomLiveStatus" : 0, "LiveRoomInfoDetail" : { "RoomId" : "0", "LiveRoomCoverUri" : "aweme-avatar/tos-cn-i-c9aec8xkvj_f55f52e1c94e48138b491f5a9c8689e2", "Title" : "", "AnchorNickname" : "罗永浩直播好物分享" }, "LiveRoomInfoExtra" : { "HasClosedShoppingCart" : false, "HasWindmill" : false, "HasBisinessComponent" : false, "IsForO2ORoom" : false } } } ], "hasMore" : true } } } ``` ## cURL ```sh curl --globoff --request POST 'https://api.getoneapi.com/api/douyin-app/search_live' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "keyword" : "罗永浩", "cursor" : 0 }' ```