Douyin-App/抖音APP

搜索-搜索直播

POST

https://api.getoneapi.com/api/douyin-app/search_live

按抖音号或抖音昵称搜索直播间，支持游标翻页。
适合定位某个主播的直播间，而不是按内容关键词泛搜直播。
keyword 匹配的是主播的抖音号或昵称，传入内容类关键词（如 "游戏"）通常匹配不到结果。
本接口不支持排序、发布时间、时长等筛选条件。
每页固定 10 条，不支持指定数量。
首次请求 cursor 传 0，翻页时传上一页响应里返回的 cursor。

请求参数

Header 参数

Authorization string 必需

在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 apikey

默认值： Bearer YOUR_API_KEY

Content-Type string 必需

默认值： application/json

Body 参数

application/json

keyword string 关键词必需

抖音号或抖音昵称（必填）

cursor string 翻页参数必需

首次请求传 0，翻页时使用上次响应的 cursor

默认值： 0

示例

{
  "keyword" : "罗永浩",
  "cursor" : 0
}

返回响应

响应 200

application/json

code integer 必需

message string 必需

data object 必需

示例

{
  "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
    }
  }
}

请求示例代码

替换 YOUR_API_KEY、参数占位符与请求数据后使用。第三方客户端需先安装对应依赖。

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
}'

更新于 2026-11-10 19:04:38