Douyin API
  1. TikTok-Web-API
Douyin API
  • Douyin-Web-API
    • 获取单个作品数据/Get single video data
    • 获取单个作品数据 V2/Get single video data V2
    • 根据分享链接获取单个作品数据/Get single video data by sharing link
    • 批量获取视频信息/Batch Get Video Information
    • 获取单个作品视频弹幕数据/Get single video danmaku data
    • 获取首页推荐数据/Get home feed data
    • 获取相关作品推荐数据/Get related posts recommendation data
    • 获取用户主页作品数据/Get user homepage video data
    • 获取用户喜欢作品数据/Get user like video data
    • 获取用户收藏作品数据/Get user collection video data
    • 获取用户收藏夹/Get user collection
    • 获取用户收藏夹数据/Get user collection data
    • 获取用户合辑作品数据/Get user mix video data
    • 获取用户直播流数据/Get user live video data
    • 通过sec_uid获取指定用户的直播流数据/Get live video data of specified user by sec_uid
    • 通过room_id获取指定用户的直播流数据 V1/Get live video data of specified user by room_id V1
    • 通过room_id获取指定用户的直播流数据 V2/Gets the live stream data of the specified user by room_id V2
    • 获取直播间送礼用户排行榜/Get live room gift user ranking
    • 抖音直播间商品信息/Douyin live room product information
    • 使用UID获取用户信息/Get user information by UID
    • 使用UID获取用户开播信息/Get user live information by UID
    • 使用Short ID获取用户信息/Get user information by Short ID
    • 使用sec_user_id获取指定用户的信息/Get information of specified user by sec_user_id
    • 使用unique_id（抖音号）获取指定用户的信息/Get information of specified user by unique_id
    • 根据抖音uid获取指定用户的信息/Get information of specified user by uid
    • 根据sec_user_id获取指定用户的信息（性别，年龄，直播等级、牌子）/Get information of specified user by sec_user_id (gender, age, live level、brand)
    • 获取用户粉丝列表/Get user fans list
    • 获取用户关注列表/Get user following list
    • 获取单个视频评论数据/Get single video comments data
    • 获取指定视频的评论回复数据/Get comment replies data of specified video
    • 获取指定关键词的综合搜索结果/Get comprehensive search results of specified keywords
    • 获取指定关键词的视频搜索结果/Get video search results of specified keywords
    • 获取指定关键词的视频搜索结果 V2 （废弃，替代接口请参考下方文档）/Get video search results of specified keywords V2 (Deprecated, please refer to the following document for replacement interface)
    • 获取指定关键词的用户搜索结果(废弃，替代接口请参考下方文档)/Get user search results of specified keywords (deprecated, please refer to the following document for replacement interface)
    • 获取指定关键词的用户搜索结果 V2 (已弃用，替代接口请参考下方文档)/Get user search results of specified keywords V2 (deprecated, please refer to the following document for replacement interface)
    • 获取指定关键词的用户搜索结果 V3 (已弃用，替代接口请参考下方文档)/Get user search results of specified keywords V3 (deprecated, please refer to the following document for replacement interface)
    • 获取指定关键词的直播搜索结果/Get live search results of specified keywords
    • 搜索话题/Search Challenge
    • 话题作品/Challenge Posts
    • 获取抖音热榜数据/Get Douyin hot search results
    • 抖音视频频道数据/Douyin video channel data
    • 获取抖音Web的游客Cookie/Get the guest Cookie of Douyin Web
    • 生成真实msToken/Generate real msToken
    • 生成ttwid/Generate ttwid
    • 生成verify_fp/Generate verify_fp
    • 抖音热点分类/Douyin Billboard Categories
    • 生成s_v_web_id/Generate s_v_web_id
    • 抖音实时上升热点榜/Douyin Real-time Rising Hot List
    • 抖音城市列表/Douyin City List
    • 使用接口网址生成X-Bogus参数/Generate X-Bogus parameter using API URL
    • 抖音同城热点榜单/Douyin City Hot List
    • 使用接口网址生成A-Bogus参数/Generate A-Bogus parameter using API URL
    • 抖音实时挑战榜单/Douyin Real-time Challenge List
    • 提取单个用户id/Extract single user id
    • 抖音热点总榜单/Douyin Hot List
    • 提取列表用户id/Extract list user id
    • 抖音榜单相关视频/Douyin Billboard Related Videos
    • 提取单个作品id/Extract single video id
    • 抖音用户粉丝画像/Douyin User Fans Portrait
    • 提取列表作品id/Extract list video id
    • 抖音用户粉丝兴趣/Douyin User Fans Interest
    • 提取直播间号/Extract webcast id
    • 抖音视频点赞观众画像/Douyin Video Like Viewer Portrait
    • 提取列表直播间号/Extract list webcast id
    • 抖音视频榜单/Douyin Video Billboard
    • 直播间号转房间号/Webcast id to room id
    • 提取直播间弹幕/Extract live room danmaku
    • 短剧作品/Series Video
    • 知识作品推荐/Knowledge Video
    • 游戏作品推荐/Game Video
    • 二次元作品推荐/Anime Video
    • 获取视频的最高画质播放链接/Get the highest quality play URL of the video
    • 音乐作品推荐/Music Video
    • 批量获取视频的最高画质播放链接/Batch get the highest quality play URL of videos
    • 美食作品推荐/Food Video
    • 获取商品详情/Get product detail
    • 获取商品SKU列表/Get product SKU list
    • 获取商品优惠券信息/Get product coupon information
    • 获取商品评价评分/Get product review score
    • 获取商品评价列表/Get product review list
    • 获取批量用户信息(最多10个)/Get batch user profile (up to 10)
    • 获取批量用户信息(最多50个)/Get batch user profile (up to 50)
    • 生成短链接
    • 加密用户uid到sec_user_id/Encrypt user uid to sec_user_id
    • 查询抖音用户基本信息/Query Douyin user basic information
    • 生成弹幕xb签名/Generate barrage xb signature
    • 抖音直播间弹幕参数获取/Douyin live room danmaku parameters
  • Douyin-App-V3-API
    • 获取单个作品数据/Get single video data
    • 获取单个作品数据 V2/Get single video data V2
    • 批量获取视频信息 V1/Batch Get Video Information V1
    • 根据分享链接获取单个作品数据/Get single video data by sharing link
    • 根据视频ID获取作品的统计数据（点赞数、下载数、播放数、分享数）/Get the statistical data of the Post according to the video ID (like count, download count, play count, share count)
    • 根据视频ID批量获取作品的统计数据（点赞数、下载数、播放数、分享数）/Get the statistical data of the Post according to the video ID (like count, download count, play count, share count)
    • 根据视频ID来增加作品的播放数/Increase the number of plays of the work according to the video ID
    • 获取指定用户的信息/Get information of specified user
    • 获取用户粉丝列表/Get user fans list
    • 获取用户关注列表 (弃用，使用 /api/v1/douyin/web/fetch_user_following_list 替代)/Get user following list (Deprecated, use /api/v1/douyin/web/fetch_user_following_list instead)
    • 获取用户主页作品数据/Get user homepage video data
    • 获取用户喜欢作品数据/Get user like video data
    • 获取单个视频评论数据/Get single video comments data
    • 获取指定视频的评论回复数据/Get comment replies data of specified video
    • 获取抖音视频合集详情数据/Get Douyin video mix detail data
    • 获取抖音视频合集作品列表数据/Get Douyin video mix post list data
    • 获取指定关键词的综合搜索结果（弃用，替代接口见下方文档说明）/Get comprehensive search results of specified keywords (deprecated, see the documentation below for alternative interfaces)
    • 获取指定关键词的视频搜索结果（弃用，替代接口见下方文档说明）/Get video search results of specified keywords (deprecated, see the documentation below for alternative interfaces)
    • 获取指定关键词的视频搜索结果 V2 （弃用，替代接口见下方文档说明）/Get video search results of specified keywords V2 (deprecated, see the documentation below for alternative interfaces)
    • 获取指定关键词的用户搜索结果（弃用，替代接口见下方文档说明）/Get user search results of specified keywords (deprecated, see the documentation below for alternative interfaces)
    • 获取指定关键词的直播搜索结果（弃用，替代接口见下方文档说明）/Get live search results of specified keywords (deprecated, see the documentation below for alternative interfaces)
    • 获取指定关键词的音乐搜索结果（弃用，替代接口见下方文档说明）/Get music search results of specified keywords (deprecated, see the documentation below for alternative interfaces)
    • 获取指定关键词的话题搜索结果（弃用，替代接口见下方文档说明）/Get hashtag search results of specified keywords (deprecated, see the documentation below for alternative interfaces)
    • 获取指定音乐的详情数据/Get details of specified music
    • 获取指定音乐的视频列表数据/Get video list of specified music
    • 获取指定话题的详情数据/Get details of specified hashtag
    • 获取指定话题的作品数据/Get video list of specified hashtag
    • 获取抖音热搜榜数据/Get Douyin hot search list data
    • 获取抖音直播热搜榜数据/Get Douyin live hot search list data
    • 获取抖音音乐榜数据/Get Douyin music hot search list data
    • 获取抖音品牌热榜分类数据/Get Douyin brand hot search list data
    • 获取抖音品牌热榜具体分类数据/Get Douyin brand hot search list detail data
    • 获取单个作品数据 V3 (无版权限制)/Get single video data V3 (No copyright restrictions)
    • 生成抖音短链接/Generate Douyin short link
    • 根据分享口令获取分享信息/Get share info by share code
    • 生成抖音视频分享二维码/Generate Douyin video share QR code
    • 批量获取视频信息 V2/Batch Get Video Information V2
    • 获取视频的最高画质播放链接/Get the highest quality play URL of the video
    • 抖音APP注册设备/Douyin APP register device
    • 批量获取视频的最高画质播放链接/Batch get the highest quality play URL of videos
    • 生成抖音分享链接，唤起抖音APP，跳转指定作品详情页/Generate Douyin share link, call Douyin APP, and jump to the specified video details page
    • 获取用户短剧合集列表/Get user series list
    • 生成抖音分享链接，唤起抖音APP，跳转指定用户主页/Generate Douyin share link, call Douyin APP, and jump to the specified user profile
    • 获取短剧视频列表/Get series video list
    • 生成抖音分享链接，唤起抖音APP，跳转指定关键词搜索结果/Generate Douyin share link, call Douyin APP, and jump to the specified keyword search result
    • 获取短剧详情信息/Get series detail
    • 生成抖音分享链接，唤起抖音APP，给指定用户发送私信/Generate Douyin share link, call Douyin APP, and send private messages to specified users
  • TikTok-Web-API
    • 获取单个作品数据/Get single video data
      GET
    • 获取探索作品数据/Get explore video data
      GET
    • 获取每日热门内容作品数据/Get daily trending video data
      GET
    • 获取用户的个人信息/Get user profile
      GET
    • 获取用户的作品列表/Get user posts
      GET
    • 获取用户的点赞列表/Get user likes
      GET
    • 获取用户的收藏列表/Get user favorites
      GET
    • 获取用户的播放列表/Get user play list
      GET
    • 获取用户的合辑列表/Get user mix list
      GET
    • 获取作品的评论列表/Get video comments
      GET
    • 获取作品的评论回复列表/Get video comment replies
      GET
    • 获取用户的粉丝列表/Get user followers
      GET
    • 获取用户的关注列表/Get user followings
      GET
    • 获取综合搜索列表/Get general search list
      GET
    • 搜索关键字推荐/Search keyword suggest
      GET
    • 搜索用户/Search user
      GET
    • 搜索视频/Search video
      GET
    • 搜索直播/Search live
      GET
    • Tag详情/Tag Detail
      GET
    • Tag作品/Tag Post
      GET
    • 首页推荐作品/Home Feed
      POST
    • 生成真实msToken/Generate real msToken
      GET
    • 生成ttwid/Generate ttwid
      GET
    • 生成 XBogus/Generate XBogus
      POST
    • 提取用户sec_user_id/Extract user sec_user_id
      GET
    • 提取列表用户sec_user_id/Extract list user sec_user_id
      POST
    • 提取单个作品id/Extract single video id
      GET
    • 获取单个作品数据 V2/Get single video data V2
      GET
    • 提取列表作品id/Extract list video id
      POST
    • 获取每日趋势搜索关键词/Get daily trending search words
      GET
    • 获取用户unique_id/Get user unique_id
      GET
    • 获取用户的转发作品列表/Get user reposts
      GET
    • 获取列表unique_id/Get list unique_id
      POST
    • 获取用户的直播详情/Get user live details
      GET
    • 提取直播间弹幕/Extract live room danmaku
      GET
    • 搜索照片/Search photo
      GET
    • 加密strData/Encrypt strData
      GET
    • 根据直播间链接提取直播间ID/Extract live room ID from live room link
      GET
    • 解密strData/Decrypt strData
      GET
    • 直播间开播状态检测/Live room start status check
      GET
    • 生成浏览器指纹/Generate browser fingerprint
      GET
    • 生成web_id/Generate web_id
      GET
    • 通过直播链接获取直播间信息/Get live room information via live link
      GET
    • 生成 XGnarly /Generate XGnarly
      POST
    • 获取直播间首页推荐列表/Get live room homepage recommendation list
      GET
    • 生成 XGnarly 和 XBogus /Generate XGnarly and XBogus
      POST
    • 提取用户user_id/Extract user user_id
      GET
    • 获取SSO登录二维码/Get SSO login QR code
      GET
    • TikTok直播间弹幕参数获取/tiktok live room danmaku parameters
      GET
    • 获取SSO登录状态/Get SSO login status
      GET
    • 批量直播间开播状态检测/Batch live room start status check
      GET
    • 认证SSO登录/Authenticate SSO login
      GET
    • 获取直播间礼物列表/Get live room gift list
      GET
    • 生成哈希ID/Generate hashed ID
      GET
    • 根据Gift ID查询礼物名称/Get gift name by gift ID
      POST
    • 批量查询Gift ID对应的礼物名称($0.025/次,建议50个)/Batch get gift names by gift IDs ($0.025/call, suggest 50)
      POST
    • 获取游客 Cookie/Get the guest Cookie
      GET
    • 设备注册/Register device for TikTok Web
      GET
  • TikTok-App-V3-API
    • 获取单个作品数据/Get single video data
    • 获取单个作品数据 V2/Get single video data V2
    • 批量获取视频信息/Batch Get Video Information
    • 批量获取视频信息 V2/Batch Get Video Information V2
    • 根据分享链接获取单个作品数据/Get single video data by sharing link
    • 获取指定用户的信息/Get information of specified user
    • 获取用户转发的作品数据/Get user repost video data
    • 获取用户主页作品数据 V1/Get user homepage video data V1
    • 获取用户喜欢作品数据/Get user like video data
    • 获取单个视频评论数据/Get single video comments data
    • 获取指定视频的评论回复数据/Get comment replies data of specified video
    • 获取指定关键词的综合搜索结果/Get comprehensive search results of specified keywords
    • 获取指定关键词的视频搜索结果/Get video search results of specified keywords
    • 获取指定关键词的用户搜索结果/Get user search results of specified keywords
    • 获取指定关键词的音乐搜索结果/Get music search results of specified keywords
    • 获取指定关键词的话题搜索结果/Get hashtag search results of specified keywords
    • 获取指定关键词的直播搜索结果/Get live search results of specified keywords
    • 获取地点搜索结果/Get location search results
    • 获取指定音乐的详情数据/Get details of specified music
    • 获取指定音乐的视频列表数据/Get video list of specified music
    • 获取指定话题的详情数据/Get details of specified hashtag
    • 获取指定话题的作品数据/Get video list of specified hashtag
    • 获取指定用户的粉丝列表数据/Get follower list of specified user
    • 获取指定用户的关注列表数据/Get following list of specified user
    • 获取指定直播间的数据/Get data of specified live room
    • 获取直播间排行榜数据/Get live room ranking list
    • 检测直播间是否在线/Check if live room is online
    • 批量检测直播间是否在线/Batch check if live rooms are online
    • 获取分享短链接/Get share short link
    • 获取分享二维码/Get share QR code
    • 获取商品搜索结果/Get product search results
    • 获取带货创作者信息/Get shopping creator information
    • 获取创作者橱窗商品列表/Get creator showcase product list
    • 通过分享链接获取店铺ID/Get Shop ID by Share Link
    • 通过分享链接获取商品ID/Get Product ID by Share Link
    • 获取商品详情数据（即将弃用，使用 fetch_product_detail_v2 代替）/Get product detail data (will be deprecated, use fetch_product_detail_v2 instead)
    • 注册设备信息/Register device information
    • 获取商品详情数据V2/Get product detail data V2
    • 获取商品详情数据V3 / Get product detail data V3
    • 获取商品评价数据/Get product review data
    • 获取商家主页Page列表数据/Get shop home page list data
    • 获取商家主页数据/Get shop home page data
    • 获取商家商品推荐数据/Get shop product recommend data
    • 获取商家商品列表数据/Get shop product list data
    • 获取商家商品列表数据 V2/Get shop product list data V2
    • 获取商家信息数据/Get shop information data
    • 获取单个作品数据 V3(支持国家参数)/Get single video data V3 (support country parameter)
    • 获取商家产品分类数据/Get shop product category data
    • 根据分享链接获取单个作品数据/Get single video data by sharing link
    • 获取直播每日榜单数据/Get live daily rank data
    • 使用用户名获取用户 user_id 和 sec_user_id/Get user_id and sec_user_id by Username
    • 获取用户音乐列表数据/Get user music list data
    • 获取指定 Webcast 用户的信息/Get information of specified Webcast user
    • 获取内容翻译数据/Get content translation data
    • 通过用户名获取用户账号国家地区/Get user account country by username
    • 获取主页视频推荐数据/Get home feed(recommend) video data
    • 获取类似用户推荐/Similar User Recommendations
    • TikTok APP加密算法/TikTok APP encryption algorithm
    • 获取用户主页作品数据 V2/Get user homepage video data V2
    • 获取直播间商品列表数据/Get live room product list data
    • 获取用户主页作品数据 V3（精简数据-更快速）/Get user homepage video data V3 (simplified data - faster)
    • 获取直播间商品列表数据 V2 /Get live room product list data V2
    • 创作者搜索洞察/Creator Search Insights
    • 根据视频ID来增加作品的播放数/Increase the number of plays of the work according to the video ID
    • 创作者搜索洞察详情/Creator Search Insights Detail
    • 加密或解密 TikTok APP 登录请求体/Encrypt or Decrypt TikTok APP login request body
    • 创作者搜索洞察趋势/Creator Search Insights Trend
    • 生成TikTok分享链接，唤起TikTok APP，跳转指定作品详情页/Generate TikTok share link, call TikTok APP, and jump to the specified video details page
    • 创作者搜索洞察相关视频/Creator Search Insights Videos
    • 生成TikTok分享链接，唤起TikTok APP，跳转指定用户主页/Generate TikTok share link, call TikTok APP, and jump to the specified user profile
    • 音乐排行榜/Music Chart List
    • 生成TikTok分享链接，唤起TikTok APP，跳转指定关键词搜索结果/Generate TikTok share link, call TikTok APP, and jump to the specified keyword search result
    • 搜索粉丝列表/Search follower list
    • 生成TikTok分享链接，唤起TikTok APP，给指定用户发送私信/Generate TikTok share link, call TikTok APP, and send private messages to specified users
    • 搜索关注列表/Search following list
    • 获取商品详情数据V4 / Get product detail data V4
  • 数据模型
    • Schemas
      • ABogusModel
      • Body_fetch_home_feed_api_v1_tiktok_web_fetch_home_feed_post
      • HTTPValidationError
      • ValidationError
      • ResponseModel
      • GetNoteInfoV5Request
      • XBogusModel
      • TikTok_APP_V3_Content_Translate
      • GetHomeFeedRequest
      • Body_fetch_user_collects_api_v1_douyin_web_fetch_user_collects_post
      • XhsWebSignRequestModel
      • Body_fetch_user_collection_videos_api_v1_douyin_web_fetch_user_collection_videos_post
      • LiveRoomBatchCheckRequest
      • Body_fetch_user_like_videos_api_v1_douyin_web_fetch_user_like_videos_post
      • TikTok_APP_Encrypt_Request
      • ChallengePostRequest
      • TikTok_APP_Login_Encrypt_Decrypt_Request
      • SearchChallengeRequest
      • ModeEnum
      • TikTok_APP_V3_Home_Feed
  1. TikTok-Web-API

批量直播间开播状态检测/Batch live room start status check

GET
/api/v1/tiktok/web/fetch_batch_check_live_alive

[中文]#

用途:#

批量直播间开播状态检测
最多支持50个直播间同时查询
如果某个直播间不存在或已下播，则对应位置返回空或null。

参数:#

room_ids: 直播间ID列表，用英文逗号分隔，如：7530611486784277278,7530633767468288782

返回:#

批量直播间开播状态列表

价格:#

定价0.025$，请尽量达到50个直播间查询，避免浪费API调用次数。

说明:#

同一个room_id不会重复返回开播状态。

[English]#

Purpose:#

Batch live room start status check
Support up to 50 live rooms query at once
If a live room does not exist or has ended, the corresponding position will return empty or null.

Parameters:#

room_ids: Live room ID list separated by commas, e.g.: 7530611486784277278,7530633767468288782

Return:#

Batch live room start status list

Price:#

Charged by the number of live rooms queried, 0.025$ per live room, please try to query 50 live rooms to avoid wasting API call counts.

Note:#

The same room_id will not return the start status repeatedly.

[示例/Example]#

room_ids = "7530611486784277278,7530633767468288782,7530636465034775310,7530604930088848142"

请求参数

Authorization
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token
示例：
Authorization: Bearer ********************
Query 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/v1/tiktok/web/fetch_batch_check_live_alive?room_ids=7530611486784277278,7530633767468288782,7530636465034775310,7530604930088848142' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200
application/json
Successful Response
Body

示例
{}
🟠422
修改于 2026-02-09 09:08:56
上一页
获取SSO登录状态/Get SSO login status
下一页
认证SSO登录/Authenticate SSO login
Built with