Browse published operations

[中文] ### 用途: - 美食作品 ### 参数: - count: 每页数量，默认为16 - refreshindex: 翻页索引，默认为1 - cookie: 用户自行提供的Cookie，推荐使用自己的抖音Cookie，否则在翻页时可能会出现数据重复的问题 - 游客cookie获取接口：https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### 返回: - 美食作品数据 # [English] ### Purpose: - Food Video ### Parameters: - count: Number per page, default is 16 - refreshindex: Paging index, default is 1 - cookie: User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging - Guest cookie acquisition interface: https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### Return: - Food Video data

[中文] ### 用途: - 知识作品 ### 参数: - count: 每页数量，默认为16 - refreshindex: 翻页索引，默认为1 - cookie: 用户自行提供的Cookie，推荐使用自己的抖音Cookie，否则在翻页时可能会出现数据重复的问题 - 游客cookie获取接口：https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### 返回: - 游戏作品数据 # [English] ### Purpose: - Knowledge Video ### Parameters: - count: Number per page, default is 16 - refreshindex: Paging index, default is 1 - cookie: User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging - Guest cookie acquisition interface: https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### Return: - Game Video data

[中文] ### 用途: - 音乐作品 ### 参数: - count: 每页数量，默认为16 - refreshindex: 翻页索引，默认为1 - cookie: 用户自行提供的Cookie，推荐使用自己的抖音Cookie，否则在翻页时可能会出现数据重复的问题 - 游客cookie获取接口：https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### 返回: - 音乐作品数据 # [English] ### Purpose: - Music Video ### Parameters: - count: Number per page, default is 16 - refreshindex: Paging index, default is 1 - cookie: User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging - Guest cookie acquisition interface: https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### Return: - Music Video data

[中文] ### 用途: - 短剧作品 ### 参数: - offset: 页码，默认为0 - count: 每页数量，默认为16 - contenttype: 子类型，默认为0 - 0: 热榜 - 101: 甜宠 - 102: 搞笑 - 104: 正能量 - 105: 成长 - 106: 悬疑 - 109: 家庭 - 110: 都市 - 112: 奇幻 - 113: 玄幻 - 114: 职场 - 115: 青春 - 116: 古装 - 117: 动作 - 119: 逆袭 - 124: 其他 - cookie: 用户自行提供的Cookie，推荐使用自己的抖音Cookie，否则在翻页时可能会出现数据重复的问题 - 游客cookie获取接口：https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### 返回: - 短剧作品数据 # [English] ### Purpose: - Series Video ### Parameters: - offset: Page number, default is 0 - count: Number per page, default is 16 - contenttype: Subtype, default is 0 - 0: Hot list - 101: Sweet pet - 102: Funny - 104: Positive energy - 105: Growth - 106: Suspense - 109: Family - 110: Urban - 112: Fantasy - 113: Fantasy - 114: Workplace - 115: Youth - 116: Ancient costume - 117: Action - 119: Counterattack - 124: Other - cookie: User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging - Guest cookie acquisition interface: https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### Return: - Series Video data

[中文] ### 用途: - 搜索TikTok广告创意库中的广告，支持多维度筛选和排序 - 发现特定行业、关键词或目标相关的高效广告案例 - 为广告策划和创意制作提供参考和灵感 ### 参数: - keyword: 搜索关键词，可选参数，留空返回所有广告 - objective: 广告目标，可选；留空表示不按目标筛选 - like: 表现分位，可选；留空表示不按表现分位筛选 - period: 时间范围（天），如7、30、120、180天 - industry: 行业ID列表，多个ID用逗号分隔。完整行业ID列表见: https://github.com/TikHub/TikTok-Ads-Industry-Code - page: 页码，默认1 - limit: 每页数量，默认20，最大50 - orderby: 排序方式，"foryou"=为你推荐，"likes"=按点赞数排序 - countrycode: 国家代码，如US、UK、JP等 - adformat: 广告格式，可选；1=Spark Ads，2=非 Spark Ads - adlanguage: 广告语言代码，可选，如en、zh-Hant等 - duration: 视频时长筛选值，可选 - patternlabel: 创意趋势标签，可选 - cookie: 自定义Cookie字符串，可选参数，可以使用自己的Cookie来获取更多数据 ### 注意: - 如果您应用了一个或多个筛选条件后没有返回任何结果，请尝试调整或移除部分筛选条件。TikTok 创作者数据集仅收录部分热门数据，不一定包含全量数据。 ### 常用行业ID示例: - 游戏: 27000000000 - 电子商务: 19000000000 - 金融服务: 30000000000 - 教育: 10000000000 - 美妆个护: 22000000000 - 食品饮料: 16000000000 ### 返回内容说明: - materials: 广告素材列表 - id: 广告素材ID - awemeid: 广告视频ID - desc: 广告描述 - createtime: 创建时间 - videoinfo: 视频信息 - cover: 封面图URL - duration: 时长（秒） - statistics: 统计数据 - diggcount: 点赞数 - commentcount: 评论数 - sharecount: 分享数 - adsinfo: 广告信息 - advertisername: 广告主名称 - landingpage: 落地页URL - pagination: 分页信息 - page: 当前页 - limit: 每页数量 - total: 总数量 - hasmore: 是否有更多 ### 示例响应: # [English] ### Purpose: - Search ads

[中文] ### 用途: - 搜索抖音用户，支持抖音号和抖音昵称搜索 ### 参数: - username: 用户名 (支持抖音号和抖音昵称) - 抖音号: 如 "rmrbxmt" - 抖音昵称: 如 "Y"、"人民日报" ### 返回: - 最多返回20个匹配的用户信息 - 包含用户基本信息如头像、昵称、抖音号等 # [English] ### Purpose: - Search Douyin users by Douyin ID or nickname ### Parameters: - username: Username (supports Douyin ID and nickname) - Douyin ID: e.g., "rmrbxmt" - Nickname: e.g., "Y", "人民日报" ### Return: - Returns up to 20 matching user information - Contains basic user info like avatar, nickname, Douyin ID, etc.

生成短链接

[中文] ### 用途: - 主播搜索(抖音直播广场)，按关键词搜索抖音直播主播，支持完整筛选条件 - 价格：0.002$ / 次 ### 参数: - keyword: 搜索关键词，可为主播昵称、抖音号、星图ID或直播内容词 - page: 页码，默认1 - sortfield: 排序字段，默认score综合排序 - sorttype: 排序方式，1=升序，2=降序，默认2 - 合作诉求: taskcategory 合作对象、marketingtarget 营销目标、firstindustryid 适配行业 - 匹配度: tag 达人类型、personatags 达人人设/学历/认证/调性、gender 性别、fansmin/fansmax 粉丝数 - 性价比: expectedplaymin/expectedplaymax 预期播放量、 cpmmin/cpmmax 预期CPM、cpemin/cpemax 预期CPE、interactratemin/interactratemax 互动率、 playoverratemin/playoverratemax 完播率、bursttextratemin/bursttextratemax 爆文率 - 报价: pricetype 固定为 9（直播报价）；pricemin/pricemax 为主播报价区间， 提供任一边界时必须同时提供 pricetype - 主题推荐: authorlistid 达人清单ID - 画像筛选 extrafilter: 观众/粉丝画像、受众画像、所在地域、连接用户数等维度靠它筛选。 传 JSON 数组字符串，每个元素形如 {"fieldname":"字段名","fieldvalue":"值"}（可选 relid）， 常用字段： - 观众性别: watchergenderfemaleratev2ge(女性占比阈值,取值 0.5/0.6/0.7/0.8), 男性用 watchergendermaleratev2ge - 观众年龄: watcheragemostnew(观众年龄居多,值为编码数组,如 [22]=24-30岁居多) 示例: extrafilter=[{"fieldname":"watchergenderfemaleratev2_ge","fieldvalue":"0.5"}] - 说明: tag/personatags 的可选ID可通过getauthormarketfields获取；动态画像字段和编码 可通过getsearchfieldoptions获取；比率类参数为0-1小数(0.02=2%) ### 返回: - 主播搜索结果数据（含主播信息、直播报价、ACU/PCU、场均观看等） # [English] ### Purpose: - Search Douyin live-stream anchors in the live marketplace by keyword, with full filtering - Price: 0.002$ / time ### Parameters: - keyword: Search keyword: nickname, Douyin ID, Xingtu ID or live content word - page: Page number, default 1 - sortfield: Sort field, default score (comprehensive sort) - sorttype: Sort type, 1=asc, 2=desc, default 2 - Cooperation: taskcategory, marketingtarget, firstindustryid - Match: tag (category), personatags, gender, fansmin/fansmax - Cost-performance: expectedplaymin/max, cpmmin/max, cpemin/max, interactratemin/max, playoverratemin/max, bursttextratemin/max - Price: pricetype is fixed to 9 for live-stream pricing; pricemin/price_max define the anchor-price

[中文] ### 用途: - 获取音乐榜单（歌曲列表，结果在 musics[]），使用游标分页。 ### 参数: - tabid: 榜单 ID，100002=热歌榜（默认），100063=π计划推荐榜 - count: 每页数量，默认 20，范围 1-50 - pcursor: 分页游标，首次留空，翻页传上一页响应的 pcursor ### 返回: - 音乐榜单数据 # [English] ### Purpose: - Fetch music ranking (songs in musics[]), with cursor pagination. ### Parameters: - tabid: 100002=hot songs (default), 100063=Pi-plan ranking - count: Page size, default 20, range 1-50 - pcursor: Cursor, empty for first page ### Returns: - Music ranking data

[中文] ### 用途: - 话题标签聚合页：给定标签，返回标签信息(tagInfo) + 关联作品流(mixFeeds[])。hashtag 页有 4 个子 tab。 ### 参数: - generaltagid: 标签 ID。话题标签传标签名（如 "清纯甜美少女"）或 searchtag 的数字 id；声音标签传编码串 - tab: hashtag 子 tab —— hot(最热门) / latest(最新发布) / image(图片) / live(直播) - tagname: 标签显示名，话题标签建议传 - tagtype: 1=话题标签（默认），29=声音/音乐标签 - tagsource: 2=搜索进入话题页（默认），3=作品页声音标签 - fromphotoid: 进入标签页的源作品 photoId（可选） - pcursor: 分页游标，首次留空，翻页传上一页响应的 pcursor ### 返回: - 标签信息 + 作品流数据 # [English] ### Purpose: - Tag aggregation page: tagInfo + related feed (mixFeeds[]). Hashtag page has 4 sub tabs. ### Parameters: - generaltagid: Tag ID. Topic tag uses tag name or searchtag's numeric id; sound tag uses encoded id. - tab: hot / latest / image / live - tagname: Tag display name (recommended for topic tags) - tagtype: 1=topic tag, 29=sound/music tag - tagsource: 2=from search, 3=sound tag from photo page - fromphotoid: Source photoId (optional) - pcursor: Cursor, empty for first page ### Returns: - Tag info + feed data

[中文] ### 用途: - 搜索接口 ### 参数: - query: 搜索关键词 - maxcursor: 翻页参数，可以从上一次请求的返回结果中获取，第一次请求为空，后续请求使用上一次请求返回的maxcursor进行翻页，可以通过返回结果的hasmore字段判断是否还有更多数据。 - filtertype: 搜索过滤类型，默认为空字符串，可选值如下： - 空字符串：All（全部，默认使用此参数搜索） - video：只搜索视频作品 - posts：只搜索文章作品 - orderby: 搜索排序方式，默认为空字符串，可选值如下： - 空字符串：Relevance（相关度，默认使用此参数排序） - popular：流行度排序 - recent：从新到旧排序 - searchtab: 搜索类型，默认为main，可选值如下： - main：APP中显示为 Top（综合搜索，默认使用此参数搜索） - user：APP中显示为 Accounts （搜索用户账号） - hashtag：APP中显示为 Hashtags（搜索话题） - article：APP中显示为 Posts（搜索文章） ### 返回: - 搜索结果 # [English] ### Purpose: - Search API ### Parameters: - query: Search keyword - maxcursor: Pagination parameter, can be obtained from the return result of the last request. It is empty for the first request, and the maxcursor returned by the last request is used for subsequent requests. You can judge whether there is more data by the hasmore field in the return result. - filtertype: Search filter type, default is an empty string, optional values are as follows: - Empty string: All (default using this parameter to search) - video: Search only video - posts: Search only posts - orderby: Search sort type, default is an empty string, optional values are as follows: - Empty string: Relevance (default using this parameter to sort) - popular: Sort by popularity - recent: Sort from new to old - searchtab: Search type, default is main, optional values are as follows: - main: Display as Top in the APP (comprehensive search, default using this parameter to search) - user: Display as Accounts in the APP (search user accounts) - hashtag: Display as Hashtags in the APP (search hashtags) - article: Display as Posts in the APP (search articles) ### Return: - Search results # [示例/Example] query = "lemon8" maxcursor = "" filtertype = "" orderby = "" searchtab = "main"

[中文] ### 用途: - 搜索接口，支持搜索用户、作品等。 ### 参数: - keyword: 搜索关键词。 - offset: 翻页游标，默认为0，后续页码从上一页返回的 offset Key中获取对应值。 - searchtype: 搜索类型，可用值如下： - 1: 综合 - 8: 热门 - 9: 新鲜 - 2：视频 - 3：图文 - 4：用户 - 5：话题 ### 返回: - 搜索结果 # [English] ### Purpose: - Search API, support search user, post, etc. ### Parameters: - keyword: Search keyword. - offset: Page cursor, default is 0, get the corresponding value from the offset Key in the previous page. - searchtype: Search type, available values are as follows: - 1: Comprehensive - 8: Hot - 9: Fresh - 2: Video - 3: Photo - 4: User - 5: Hashtag ### Return: - Search result # [示例/Example] keyword = "皮皮虾" offset = "0" search_type = "1"

[中文] ### 用途: - 通过邮件ID获取邮件数据 ### 参数: - token: 邮箱Bearer Token - messageid: 邮件ID ### 返回: - 邮件数据 # [English] ### Purpose: - Get email data by email ID ### Parameters: - token: Email Bearer Token - messageid: Email ID ### Returns: - Email data

[中文] ### 用途: - 获取邮件列表 ### 参数: - token: 邮箱Bearer Token ### 返回: - emails: 邮件列表 # [English] ### Purpose: - Get a list of emails ### Parameters: - token: Email Bearer Token ### Returns: - emails: List of emails

[中文] ### 用途: - 获取一个临时邮箱地址 - 用于注册或者接收邮件，该邮箱地址不会被删除，也不会被其他人使用。 - 该邮箱无法发送邮件，只能接收邮件。 - 请自行保存邮箱地址、用户名、密码、Bearer Token，我们无法帮助您找回这些关键信息。 ### 参数: - 无 ### 返回: - domain: 邮箱域名 - name: 邮箱用户名 - password: 邮箱密码 - emailaddress: 邮箱地址 - token: 邮箱Bearer Token # [English] ### Purpose: - Get a temporary email address - Used for registration or receiving emails, this email address will not be deleted or used by others. - This email cannot send emails, only receive emails. - Please save the email address, username, password, and Bearer Token yourself, we cannot help you retrieve this critical information. ### Parameters: - None ### Returns: - domain: Email domain - name: Email username - password: Email password - emailaddress: Email address - token: Email Bearer Token

[中文] ### 用途: - 首页推荐作品 ### 参数: - count: 每页数量 - cookie: 用户自己的cookie，可选参数，用于接口返回数据的个性化推荐。 - region: 地区代码，可选参数，影响推荐内容所属地区，如 US/GB/JP/KR/SG 等，默认 US。 ### 返回: - 首页推荐作品 ### 备注: - 此接口返回的视频CDN直链需要携带返回的 ttchaintoken 才能访问，否则会返回 HTTP 403。 - 访问视频CDN直链时，请在请求头中携带 Cookie: ttchaintoken={ttchaintoken}，其中 {ttchaintoken} 替换为接口返回的值。 - 如果视频CDN直链仍返回 HTTP 403: 1. 请改用响应中以 https://www.tiktok.com/aweme/v1/play/ 开头的视频链接(位于 video 下各 UrlList 中) 2. 请求该链接时不要携带任何 Cookie，携带 ttchaintoken 会导致 HTTP 403 - 如果需要无需任何 Cookie 即可直接访问的无水印视频链接，请使用 /fetchpostdetail 或 TikTok APP V3 目录下的接口。 # [English] ### Purpose: - Home Feed ### Parameters: - count: Number per page - cookie: User's own cookie, optional parameter, used for personalized recommendations of interface return data. - region: Region code, optional parameter, affects the region of recommended content, e.g. US/GB/JP/KR/SG, default US. ### Return: - Home Feed ### Note: - The direct video CDN links returned by this interface require the returned ttchaintoken to be accessed, otherwise HTTP 403 will be returned. - When accessing a direct video CDN link, carry Cookie: ttchaintoken={ttchaintoken} in the request header, where {ttchaintoken} is the value returned by this interface. - If a direct video CDN link still returns HTTP 403: 1. Use the video link starting with https://www.tiktok.com/aweme/v1/play/ from the response instead (found in the UrlList fields under video) 2. Send that link without any Cookie - carrying ttchaintoken will cause HTTP 403 - If you need watermark-free video links that require no Cookie at all, use /fetchpostdetail or the interfaces under the TikTok APP V3 directory. # [示例/Example] count = 15 Cookie = "Your_Cookie" region = "US"

[中文] ### 用途: - 搜索直播 ### 参数: - keyword: 搜索关键词 - count: 每页数量 - offset: 翻页游标，第一次请求时为0，第二次请求时从上一次请求的返回响应中获取。 - searchid: 搜索id，第一次请求时为空，第二次翻页时需要提供，需要从上一次请求的返回响应中获取。 - 例如: searchid = "20240828035554C02011379EBB6A00E00B" - JSON Path-1 : $.data.extra.logid - JSON Path-2 : $.data.logpb.imprid - cookie: 用户cookie(如果你需要使用自己的账号搜索，或者遇到接口报错，可以自行提供cookie，默认不需要提供) ### 返回: - 直播列表 # [English] ### Purpose: - Search live ### Parameters: - keyword: Search keyword - count: Number per page - offset: Page offset, 0 for the first request, need to provide for the second paging. - searchid: Search id, empty for the first request, need to provide for the second paging, need to get it from the return response of the last request. - For example: searchid = "20240828035554C02011379EBB6A00E00B" - JSON Path-1 : $.data.extra.logid - JSON Path-2 : $.data.logpb.imprid - cookie: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required) ### Return: - Live list # [示例/Example] keyword = "TikTok" count = 20 offset = 0 search_id = ""

[中文] ### 用途: - 搜索照片 ### 参数: - keyword: 搜索关键词 - count: 每页数量，建议保持默认值20。 - offset: 翻页游标，第一次请求时为0，第二次请求时从上一次请求的返回响应中获取，一般这个值的关键字为offset或者cursor。 - searchid: 搜索id，第一次请求时为空，第二次翻页时需要提供，需要从上一次请求的返回响应中获取。 - 例如: searchid = "20240828035554C02011379EBB6A00E00B" - JSON Path-1 : $.data.extra.logid - JSON Path-2 : $.data.logpb.imprid - cookie: 用户cookie(如果你需要使用自己的账号搜索，或者遇到接口报错，可以自行提供cookie，默认不需要提供) ### 返回: - 视频列表 # [English] ### Purpose: - Search photo ### Parameters: - keyword: Search keyword - count: Number per page, it is recommended to keep the default value 20. - offset: Page cursor, 0 for the first request, need to provide for the second paging, generally the keyword of this value is offset or cursor. - searchid: Search id, empty for the first request, need to provide for the second paging, need to get it from the return response of the last request. - For example: searchid = "20240828035554C02011379EBB6A00E00B" - JSON Path-1 : $.data.extra.logid - JSON Path-2 : $.data.logpb.imprid - offset: Page cursor - cookie: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required) ### Return: - Video list # [示例/Example] keyword = "TikTok" count = 20 offset = 0 search_id = ""

[中文] ### 用途: - 搜索用户 ### 参数: - keyword: 搜索关键词 - cursor: 翻页游标，第一次请求时为0，第二次请求时从上一次请求的返回响应中获取，一般这个值的关键字为offset或者cursor。 - searchid: 搜索id，第一次请求时为空，第二次翻页时需要提供，需要从上一次请求的返回响应中获取。 - 例如: searchid = "20240828035554C02011379EBB6A00E00B" - JSON Path-1 : $.data.extra.logid - JSON Path-2 : $.data.logpb.imprid - cookie: 用户cookie(如果你需要使用自己的账号搜索，或者遇到接口报错，可以自行提供cookie，默认不需要提供) ### 返回: - 用户列表 ### 备注: - 如果接口响应的 data 字段中的 statuscode 不为0，说明搜索请求未成功，此时请检查响应里的异常，有可能你在搜索 TikTok 不允许的关键词，或者搜索了敏感内容，请更换关键词重试。 # [English] ### Purpose: - Search user ### Parameters: - keyword: Search keyword - cursor: Page cursor, 0 for the first request, need to provide for the second paging, generally the keyword of this value is offset or cursor. - searchid: Search id, empty for the first request, need to provide for the second paging, need to get it from the return response of the last request. - For example: searchid = "20240828035554C02011379EBB6A00E00B" - JSON Path-1 : $.data.extra.logid - JSON Path-2 : $.data.logpb.imprid - cookie: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required) ### Return: - User list ### Note: - If the statuscode in the data field of the interface response is not 0, it means that the search request was not successful. Please check the exceptions in the response. You may be searching for keywords that TikTok does not allow, or searching for sensitive content. Please change the keywords and try again. # [示例/Example] keyword = "TikTok" cursor = 0 search_id = ""

[中文] ### 用途: - 搜索视频 ### 参数: - keyword: 搜索关键词 - count: 每页数量，建议保持默认值20。 - offset: 翻页游标，第一次请求时为0，第二次请求时从上一次请求的返回响应中获取。 - searchid: 搜索id，第一次请求时为空，第二次翻页时需要提供，需要从上一次请求的返回响应中获取。 - 例如: searchid = "20240828035554C02011379EBB6A00E00B" - JSON Path-1 : $.data.extra.logid - JSON Path-2 : $.data.logpb.imprid - cookie: 用户cookie(如果你需要使用自己的账号搜索，或者遇到接口报错，可以自行提供cookie，默认不需要提供) ### 返回: - 视频列表 # [English] ### Purpose: - Search video ### Parameters: - keyword: Search keyword - count: Number per page, it is recommended to keep the default value 20. - offset: Page offset, 0 for the first request, need to provide for the second paging. - searchid: Search id, empty for the first request, need to provide for the second paging, need to get it from the return response of the last request. - For example: searchid = "20240828035554C02011379EBB6A00E00B" - JSON Path-1 : $.data.extra.logid - JSON Path-2 : $.data.logpb.imprid - cookie: User cookie (If you need to search with your own account, or encounter an interface error, you can provide the cookie yourself, default is not required) ### Return: - Video list # [示例/Example] keyword = "TikTok" count = 20 offset = 0 search_id = ""

[中文] ### 用途: - Tag详情 ### 参数: - tagname: Tag名称 ### 返回: - Tag详情 # [English] ### Purpose: - Tag Detail ### Parameters: - tagname: Tag name ### Return: - Tag Detail # [示例/Example] tag_name = "tiktok"

[中文] ### 用途: - Tag作品 ### 参数: - challengeID: Tag ID - count: 每页数量 - cursor: 翻页游标 ### 返回: - Tag作品 ### 备注: - 此接口返回的视频CDN直链需要携带返回的 ttchaintoken 才能访问，否则会返回 HTTP 403。 - 访问视频CDN直链时，请在请求头中携带 Cookie: ttchaintoken={ttchaintoken}，其中 {ttchaintoken} 替换为接口返回的值。 - 如果视频CDN直链仍返回 HTTP 403: 1. 请改用响应中以 https://www.tiktok.com/aweme/v1/play/ 开头的视频链接(位于 video 下各 UrlList 中) 2. 请求该链接时不要携带任何 Cookie，携带 ttchaintoken 会导致 HTTP 403 - 如果需要无需任何 Cookie 即可直接访问的无水印视频链接，请使用 /fetchpostdetail 或 TikTok APP V3 目录下的接口。 # [English] ### Purpose: - Tag Post ### Parameters: - challengeID: Tag ID - count: Number per page - cursor: Page cursor ### Return: - Tag Post ### Note: - The direct video CDN links returned by this interface require the returned ttchaintoken to be accessed, otherwise HTTP 403 will be returned. - When accessing a direct video CDN link, carry Cookie: ttchaintoken={ttchaintoken} in the request header, where {ttchaintoken} is the value returned by this interface. - If a direct video CDN link still returns HTTP 403: 1. Use the video link starting with https://www.tiktok.com/aweme/v1/play/ from the response instead (found in the UrlList fields under video) 2. Send that link without any Cookie - carrying ttchaintoken will cause HTTP 403 - If you need watermark-free video links that require no Cookie at all, use /fetchpostdetail or the interfaces under the TikTok APP V3 directory. # [示例/Example] challengeID = "7551" count = 30 cursor = 0

[中文] ### 用途: - 获取推文下的评论 ### 参数: - tweetid: 推文ID - cursor: 游标，默认为None，用于翻页，后续从上一次请求的返回结果中获取 ### 返回: - 评论 # [English] ### Purpose: - Get comments under the tweet ### Parameters: - tweetid: Tweet ID - cursor: Cursor, default is None, used for paging, obtained from the last request ### Return: - Comments # [示例/Example] tweet_id = "1808168603721650364" cursor = None

[中文] ### 用途: - 搜索 ### 参数: - keyword: 搜索关键字 - searchtype: 搜索类型，默认为Top，其他可选值为Latest，Media，People, Lists - cursor: 游标，默认为None，用于翻页，后续从上一次请求的返回结果中获取 ### 返回: - 搜索结果 ### 关于搜索结果准确性的说明: - X 的搜索并不保证关键词或话题标签一定出现在推文正文（text 字段）中。 - 匹配范围远大于正文，还包括：被引用的推文、外链文章的元数据、媒体内容以及账号信号。 - 因此返回的推文完全可能是一条合法匹配，但关键词根本不在 text 字段里。 - 如果在结果上再做一次"正文必须包含关键词"的字面子串过滤，会丢弃掉很大一部分有效结果 （实测可达 94.6% 的丢弃率）。 - 若发现结果看起来"不准"，请优先检查是否在调用侧做了这类字面过滤。 # [English] ### Purpose: - Search ### Parameters: - keyword: Search keyword - searchtype: Search type, default is Top, other optional values are Latest, Media, People, Lists - cursor: Cursor, default is None, used for paging, obtained from the last request ### Return: - Search results ### Note on search result accuracy: - X's search does not guarantee the keyword or hashtag appears in the tweet text. - Matching happens against more than the caption — it can include the quoted tweet, linked article metadata, media, and account signals. - So a returned tweet can be a legitimate match with the term absent from the text field entirely. - Requiring a literal substring match in text will discard a large share of valid results, which is consistent with the 94.6% drop rate observed in practice. - If results look inaccurate, first check whether such a literal filter is being applied downstream. # [示例/Example] keyword = "Elon Musk" search_type = "Top" cursor = None

[中文] ### 用途: - 获取趋势 ### 参数: - country: 国家，默认为UnitedStates，其他可选值见下方 - China - India - Japan - Russia - Germany - Indonesia - Brazil - France - UnitedKingdom - Turkey - Italy - Mexico - SouthKorea - Canada - Spain - SaudiArabia - Egypt - Australia - Poland - Iran - Pakistan - Vietnam - Nigeria - Bangladesh - Netherlands - Argentina - Philippines - Malaysia - Colombia - UniteArabEmirates - Romania - Belgium - Switzerland - Singapore - Sweden - Norway - Austria - Kazakhstan - Algeria - Chile - Czechia - Peru - Iraq - Israel - Ukraine - Denmark - Portugal - Hungary - Greece - Finland - NewZealand - Belarus - Slovakia - Serbia - Lithuania - Luxembourg - Estonia ### 返回: - 趋势 # [English] ### Purpose: - Get Trending ### Parameters: - country: Country, default is UnitedStates, other optional values are as follows - China - India - Japan - Russia - Germany - Indonesia - Brazil - France - UnitedKingdom - Turkey - Italy - Mexico - SouthKorea - Canada - Spain - SaudiArabia - Egypt - Australia - Poland - Iran - Pakistan - Vietnam - Nigeria - Bangladesh - Netherlands - Argentina - Philippines - Malaysia - Colombia - UniteArabEmirates - Romania - Belgium - Switzerland - Singapore - Sweden - Norway - Austria - Kazakhstan - Algeria - Chile - Czechia - Peru ### Return: - Trending # [示例/Example] country = "UnitedStates"

[中文] ### 用途: - 搜索微博用户，支持多种筛选条件。 ### 参数: - query: 搜索关键词（可选） - page: 页码（默认1） - region: 地区编码，从/fetchcitylist获取（可选） - auth: 认证类型 orgvip/pervip/ord（可选） - gender: 性别 man/women（可选） - age: 年龄段 18y/22y/29y/39y/40y（可选） - nickname: 昵称筛选（可选） - tag: 标签筛选（可选） - school: 学校筛选（可选） - work: 公司筛选（可选） ### 返回: - 用户列表，包含uid、昵称、头像、粉丝数、主页链接 ### 注意: - 筛选参数过多可能导致无结果 # [English] ### Purpose: - Search Weibo users with multiple filter options. ### Parameters: - query: Search keyword (optional) - page: Page number (default 1) - region: Region code from /fetchcitylist (optional) - auth: Auth type orgvip/pervip/ord (optional) - gender: Gender man/women (optional) - age: Age bucket 18y/22y/29y/39y/40y (optional) - nickname: Nickname filter (optional) - tag: Tag filter (optional) - school: School filter (optional) - work: Company filter (optional) ### Return: - User list with uid, nickname, avatar, fans count, profile URL ### Note: - Too many filters may result in no results # [示例/Example] query = "yu7" page = 1

[中文] ### 用途: - 搜索视频 ### 参数: - keyword: 关键词 - offset: 偏移量，第一次请求传0，后续请求传上一次请求返回的offset - ordertype: 排序方式，为空时按照默认排序，以下为可选排序方式。 - 最新: publishtime - 最热: playcount - minduration: 最小时长，默认空，单位秒。 - maxduration: 最大时长，默认空，单位秒。 ### 返回: - 视频列表 # [English] ### Purpose: - Search video ### Parameters: - keyword: Keyword - offset: Offset, pass 0 for the first request, pass the offset returned by the previous request for subsequent requests - ordertype: Order type, empty for default sorting, the following are optional sorting methods. - Newest: publishtime - Hottest: playcount - minduration: Minimum duration, default empty, in seconds. - maxduration: Maximum duration, default empty, in seconds. ### Return: - Video list # [示例/Example] > 搜索关键字为“抖音”的视频，按照播放量排序，时长1-180秒(1-3分钟) > Search for videos with the keyword "抖音", sorted by play count, duration 1-180 seconds (1-3 minutes) keyword: "抖音" ordertype: "playcount" minduration: 1 maxduration: 180

[中文] ### 用途: - 搜索视频。 ### 参数: - searchquery: 搜索关键字。 - languagecode: 语言代码，默认为en。 - orderby: 排序方式，默认为thismonth，可选值为thisweek, thismonth, thisyear, lasthour, today。 - countrycode: 国家代码，默认为us。 - continuationtoken: 用于继续获取搜索结果的令牌。默认为None。 ### 返回: - 搜索结果。 # [English] ### Purpose: - Search video. ### Parameters: - searchquery: Search keyword. - languagecode: Language code, default is en. - orderby: Order by, default is thismonth, optional values are thisweek, thismonth, thisyear, lasthour, today. - countrycode: Country code, default is us. - continuationtoken: Token to continue fetching search results. Default is None. ### Returns: - Search results. # [示例/Example] search_query = "Minecraft"

Public TikTok profile by username (uniqueId) or secUid.

[中文] ### 用途: - 根据关键词搜索Instagram上可用的音乐 ### 参数: - keyword: 搜索关键词 ### 返回: - data.items: 音乐列表，包含标题、艺术家、时长、音频ID等 ### 价格: - 0.002 USD/请求 # [English] ### Purpose: - Search available music on Instagram by keyword ### Parameters: - keyword: Search keyword ### Return: - data.items: List of music with title, artist, duration, audio ID, etc. ### Price: - 0.002 USD/request # [示例/Example] keyword = "happy"

[中文] ### 用途: - 根据关键词搜索Instagram用户 ### 参数: - keyword: 搜索关键词 ### 返回: - data.items: 用户列表 ### 价格: - 0.002 USD/请求 # [English] ### Purpose: - Search Instagram users by keyword ### Parameters: - keyword: Search keyword ### Return: - data.items: List of users ### Price: - 0.002 USD/request # [示例/Example] keyword = "instagram"

[中文] ### 用途: - 综合搜索（返回所有类型的搜索结果） ### 参数: - keyword: 搜索关键词（必填） - cursor: 翻页游标。首页留空；翻页时把上一页响应里返回的 data.pagination.next 原样传回。 本接口为游标翻页，不支持按页码随机跳转。 - pagesize: 每页结果数量 - order: 排序方式（0=综合排序） ### 返回: - 搜索结果，包含nav（分类导航）、item（搜索结果）、pagination（分页信息）等 - 下一页游标：$.data.data.pagination.next，把它作为下一次请求的 cursor 传回； 当该字段缺失（末页时不返回 pagination）或为空字符串时，表示没有更多数据，应停止翻页 # [English] ### Purpose: - search all (returns all types of search results) ### Parameters: - keyword: Search keyword (required) - cursor: Pagination cursor. Leave empty for the first page; for the next page pass back data.pagination.next from the previous response. This endpoint uses cursor pagination and does not support random access by page number. - pagesize: Results per page - order: Sort order (0=comprehensive) ### Return: - Search results including nav (category navigation), item (results), pagination, etc. - Next-page cursor: $.data.data.pagination.next; pass it back as cursor on the next request. When this field is absent (pagination is omitted on the last page) or empty, there is no more data and you should stop paginating. # [示例/Example] keyword = "原神" cursor = "" page_size = 20

[中文] ### 用途: - Instagram用户搜索接口 - 仅返回用户搜索结果 ### 参数: - query: 搜索关键词 - ranktoken: 上一次搜索返回的ranktoken，用于翻页 ### 返回: - data.users: 用户搜索结果列表 - data.ranktoken: 排序token - data.seemore: 更多信息 - data.informmodule: 提示模块 ### 价格: - 0.008 USD/请求 # [English] ### Purpose: - Instagram user search API - Returns only user search results ### Parameters: - query: Search keyword - ranktoken: Rank token from previous search response for pagination ### Return: - data.users: User search results - data.ranktoken: Rank token - data.seemore: See more info - data.inform_module: Inform module ### Price: - 0.008 USD/request ### 示例/Example query = "justin"

[中文] ### 用途: - 关键词搜索正在直播的直播间，使用游标分页。 ### 参数: - keyword: 搜索关键词 - pcursor: 分页游标，首次留空，翻页传上一页响应的 pcursor ### 返回: - 直播间搜索结果 # [English] ### Purpose: - Search live rooms by keyword, with cursor pagination. ### Parameters: - keyword: Search keyword - pcursor: Cursor, empty for first page ### Returns: - Live search results

[中文] ### 用途: - 关键词搜索音乐（歌曲名 / 歌手 / 关键词），使用游标分页。 ### 参数: - keyword: 歌曲名 / 歌手 / 关键词 - pcursor: 分页游标，首次留空，翻页传上一页响应的 pcursor ### 返回: - 音乐搜索结果 # [English] ### Purpose: - Search music by keyword (song / artist), with cursor pagination. ### Parameters: - keyword: Song / artist / keyword - pcursor: Cursor, empty for first page ### Returns: - Music search results

[中文] ### 用途: - 关键词搜索话题标签（hashtag），结果在 tags[] 中。可配合 /fetchtagfeed 翻该标签内容流。 ### 参数: - keyword: 话题关键词 - pcursor: 分页游标，首次留空，翻页传上一页响应的 pcursor ### 返回: - 话题标签搜索结果 # [English] ### Purpose: - Search tags (hashtags) by keyword. Use /fetchtagfeed to browse a tag's feed. ### Parameters: - keyword: Tag keyword - pcursor: Cursor, empty for first page ### Returns: - Tag search results

[中文] ### 用途: - 根据关键词搜索小红书群聊列表，支持分页 ### 参数: - keyword: 搜索关键词（必需），如 "上海" - pageno: 页码，从 0 开始 - searchid: 搜索ID，翻页时传入首次搜索返回的值 - source: 来源，默认 "unifiedSearchGroup" - isrecommend: 是否推荐，0=否, 1=是 ### 返回: - 搜索结果数据，包含群聊列表和分页信息 ### 翻页说明: - 首次请求：searchid 留空（自动生成），pageno 传 0 - 翻页请求：传入首次搜索返回的 searchid，pageno 递增 # [English] ### Purpose: - Search Xiaohongshu groups by keyword, supports pagination ### Parameters: - keyword: Search keyword (required), e.g. "上海" - pageno: Page number, start from 0 - searchid: Search ID, pass value from first search response for pagination - source: Source, default "unifiedSearchGroup" - isrecommend: Is recommend, 0=no, 1=yes ### Return: - Search result data, including group list and pagination info ### Pagination Guide: - First request: leave searchid empty (auto-generated), pageno pass 0 - Next page: pass searchid from first search response, increment pageno # [示例/Example] keyword="上海" page_no=0

[中文] ### 用途: - 根据关键词搜索小红书图片，每页返回 20 条结果，支持分页 ### 参数: - keyword: 搜索关键词（必需），如 "壁纸" - page: 页码，从 1 开始 - searchid: 搜索ID，翻页时传入首次搜索返回的值 - searchsessionid: 搜索会话ID，翻页时传入首次搜索返回的值 - wordrequestid: 词请求ID，翻页时传入首次搜索返回的值 - source: 来源，默认 "explorefeed" ### 返回: - 搜索结果数据，包含图片列表和分页信息 ### 翻页说明: - 首次请求：只传keyword和page - 翻页请求：传入首次搜索返回的 searchid、searchsessionid 和 wordrequestid # [English] ### Purpose: - Search Xiaohongshu images by keyword, returns 20 results per page, supports pagination ### Parameters: - keyword: Search keyword (required), e.g. "壁纸" - page: Page number, start from 1 - searchid: Search ID, pass value from first search response for pagination - searchsessionid: Search session ID, pass value from first search response for pagination - wordrequestid: Word request ID, pass value from first search response for pagination - source: Source, default "explorefeed" ### Return: - Search result data, including image list and pagination info ### Pagination Guide: - First request: only pass keyword and page - Next page: pass searchid, searchsessionid, and wordrequestid from first search response # [示例/Example] keyword="壁纸" page=1

[中文] ### 用途: - 根据关键词搜索小红书笔记，支持多种排序方式、笔记类型筛选和发布时间筛选 ### 参数: - keyword: 搜索关键词（必需），如 "美食推荐" - page: 页码，从 1 开始 - sorttype: 排序方式 - "general": 综合排序（默认） - "timedescending": 按时间倒序（最新） - "popularitydescending": 按点赞数排序（最多点赞） - "commentdescending": 按评论数排序（最多评论） - "collectdescending": 按收藏数排序（最多收藏） - "englishpreferred": 英文优先 - notetype: 笔记类型筛选 - "不限": 所有类型（默认） - "视频笔记": 仅视频 - "普通笔记": 仅图文 - "直播笔记": 仅直播 - timefilter: 发布时间筛选 - "不限": 所有时间（默认） - "一天内": 24小时内 - "一周内": 7天内 - "半年内": 6个月内 - searchid: 搜索ID，翻页时传入首次搜索返回的值 - searchsessionid: 搜索会话ID，翻页时传入首次搜索返回的值 - source: 来源，默认 "explorefeed" - aimode: AI模式，0=关闭, 1=开启 ### 返回: - 搜索结果数据，包含笔记列表和分页信息 ### 翻页说明: - 首次请求：只传keyword和page - 翻页请求：传入首次搜索返回的 searchid 和 searchsessionid # [English] ### Purpose: - Search Xiaohongshu notes by keyword, supports multiple sort types, note type filters, and time filters ### Parameters: - keyword: Search keyword (required), e.g. "美食推荐" - page: Page number, start from 1 - sorttype: Sort type - "general": General sort (default) - "timedescending": Sort by time descending (latest) - "popularitydescending": Sort by like count (most liked) - "commentdescending": Sort by comment count (most commented) - "collectdescending": Sort by collect count (most collected) - "englishpreferred": English preferred - notetype: Note type filter - "不限": All types (default) - "视频笔记": Video notes only - "普通笔记": Image notes only - "直播笔记": Live notes only - timefilter: Time filter - "不限": All time (default) - "一天内": Within 24 hours - "一周内": Within 7 days - "半年内": Within 6 months - searchid: Search ID, pass value from first search response for pagination - searchsessionid: Search session ID, pass value from first search response for pagination - source: Source, default "explorefeed" - aimode: AI mode, 0=off, 1=on ### Return: - Search result data, including note list and pagination info ### Pagination Guide: - First request: only pass keyword and page - Next page: pass searchid and searchsessionid from first

[中文] ### 用途: - 根据关键词搜索小红书用户，每页返回 20 条结果，支持分页 ### 参数: - keyword: 搜索关键词（必需），如 "美食博主" - page: 页码，从 1 开始 - searchid: 搜索ID，翻页时传入首次搜索返回的值 - source: 来源，默认 "explorefeed" ### 返回: - 搜索结果数据，包含用户列表和分页信息 ### 翻页说明: - 首次请求：只传keyword和page - 翻页请求：传入首次搜索返回的 searchid # [English] ### Purpose: - Search Xiaohongshu users by keyword, returns 20 results per page, supports pagination ### Parameters: - keyword: Search keyword (required), e.g. "美食博主" - page: Page number, start from 1 - searchid: Search ID, pass value from first search response for pagination - source: Source, default "explorefeed" ### Return: - Search result data, including user list and pagination info ### Pagination Guide: - First request: only pass keyword and page - Next page: pass searchid from first search response # [示例/Example] keyword="美食博主" page=1

> ⚠️ 注意 / Note > > 本接口由有限的资源池提供服务，在高并发或资源紧张时可能间歇性返回 400 或其他错误。 > 此类失败通常是暂时性的，重试即可成功。建议客户端实现自动重试机制，推荐 retry = 3。 > > This endpoint is served from a limited resource pool and may intermittently return > 400 or other errors under load. Such failures are typically transient and succeed > on retry. We recommend implementing automatic retries with retry = 3. # [中文] ### 用途: - 按关键词与过滤条件搜索职位。 ### 参数: - keywords: 搜索关键词。 - geocode: LinkedIn 地区码，默认 92000000（全球）。 - dateposted / sortby: 发布时间与排序方式。 - experiencelevels / companyids / titleids / onsiteremotes / functions / industries / jobtypes: 列表型过滤项，同名参数可重复传递多个值。 - start: 翻页偏移，第 1 页传 0，第 2 页传 25，以此类推。 ### 返回: - data: 职位列表（公司、标题、地点、薪资、发布时间等）；total: 结果总数。 # [English] ### Purpose: - Search jobs by keywords and filters. ### Parameters: - keywords: Search keywords. - geocode: LinkedIn geo code. Defaults to 92000000 (worldwide). - dateposted / sortby: Posting-time filter and sort order. - experiencelevels / companyids / titleids / onsiteremotes / functions / industries / jobtypes: List filters — repeat the same parameter to pass multiple values. - start: Pagination offset — 0 for page 1, 25 for page 2, and so on. ### Returns: - data: list of jobs (company, title, location, salary, posted time, …); total: total number of results. # [示例/Example] keywords = "marketing", geocode = 92000000, companyids = 1035

[中文] ### 用途: - 二次元作品 ### 参数: - count: 每页数量，默认为16 - refreshindex: 翻页索引，默认为1 - cookie: 用户自行提供的Cookie，推荐使用自己的抖音Cookie，否则在翻页时可能会出现数据重复的问题 - 游客cookie获取接口：https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### 返回: - 二次元作品数据 # [English] ### Purpose: - Cartoon Video ### Parameters: - count: Number per page, default is 16 - refreshindex: Paging index, default is 1 - cookie: User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging - Guest cookie acquisition interface: https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### Return: - Cartoon Video data

[中文] ### 用途: - 知识作品 ### 参数: - count: 每页数量，默认为16 - refreshindex: 翻页索引，默认为1 - cookie: 用户自行提供的Cookie，推荐使用自己的抖音Cookie，否则在翻页时可能会出现数据重复的问题 - 游客cookie获取接口：https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### 返回: - 知识作品数据 # [English] ### Purpose: - Knowledge Video ### Parameters: - count: Number per page, default is 16 - refreshindex: Paging index, default is 1 - cookie: User provided Cookie, it is recommended to use your own Douyin Cookie, otherwise there may be a problem of data duplication when paging - Guest cookie acquisition interface: https://api.tikhub.io/api/v1/douyin/web/fetchdouyinwebguestcookie ### Return: - Knowledge Video data

[中文] ### 用途: - 获取内容翻译数据 ### 参数: - trglang: 目标语言 - zh-Hans: 简体中文 - zh-Hant: 繁体中文 - en: 英语 - ja: 日语 - ko: 韩语 - fr: 法语 - de: 德语 - ru: 俄语 - es: 西班牙语 - pt: 葡萄牙语 - vi: 越南语 - th: 泰语 - id: 印尼语 - ar: 阿拉伯语 - it: 意大利语 - tr: 土耳其语 - he: 希伯来语 - pl: 波兰语 - nl: 荷兰语 - sv: 瑞典语 - da: 丹麦语 - fi: 芬兰语 - no: 挪威语 - cs: 捷克语 - hu: 匈牙利语 - srccontent: 源内容，也就是需要翻译的内容，长度不超过5000个字符，如果超过5000个字符，只会翻译前5000个字符。 ### 返回: - 内容翻译数据 # [English] ### Purpose: - Get content translation data ### Parameters: - trglang: Target language - zh-Hans: Simplified Chinese - zh-Hant: Traditional Chinese - en: English - ja: Japanese - ko: Korean - fr: French - de: German - ru: Russian - es: Spanish - pt: Portuguese - vi: Vietnamese - th: Thai - id: Indonesian - ar: Arabic - it: Italian - tr: Turkish - he: Hebrew - pl: Polish - nl: Dutch - sv: Swedish - da: Danish - fi: Finnish - no: Norwegian - cs: Czech - hu: Hungarian - srccontent: Source content, that is, the content that needs to be translated, the length does not exceed 5000 characters, if it exceeds 5000 characters, only the first 5000 characters will be translated. ### Return: - Content translation data # [示例/Example] trglang = "zh-Hans" srccontent = "Hello, welcome to TikHub!"

[中文] ### 用途: - 获取直播间商品列表数据 ### 参数: - roomid: 直播间id，必填参数。 - authorid: 主播id，必填参数。 - pagesize: 每页数量，可选参数，默认为15。 - offset: 翻页游标，可选参数，默认为0，每次翻页增加15。 - region: 地区，可选参数，默认为US，如果使用其他地区，如：VN，请自行携带Cookie，否则无法获取数据。 - cookie: 用户自己的cookie，可选参数，用于爬取除US以外的地区数据。 ### 参数获取: - 第一步：使用接口f"{TikHubDomain}/api/v1/tiktok/web/getliveroomid"接口获取直播间id（roomid）。 - 第二步：使用接口f"{TikHubDomain}/api/v1/tiktok/app/v3/fetchliveroominfo"接口获取直播间信息。 - 第三步：使用第二步返回的JSON数据中使用JSONPATH获取$.data.data.owner.idstr字段的值作为主播id（authorid）。 ### 返回: - 直播间商品列表数据 # [English] ### Purpose: - Get live room product list data ### Parameters: - roomid: Live room id, required parameter. - authorid: Anchor id, required parameter. - pagesize: Number per page, optional parameter, default is 15. - offset: Page turning cursor, optional parameter, default is 0, increasing by 15 each time. - region: Region, optional parameter, default is US, if you use other regions, such as: VN, please bring your own Cookie, otherwise you will not be able to get data. - cookie: User's own cookie, optional parameter, used to crawl data from regions other than US. ### Get Parameters: - Step 1: Use the interface f"{TikHubDomain}/api/v1/tiktok/web/getliveroomid" to get the live room id (roomid). - Step 2: Use the interface f"{TikHubDomain}/api/v1/tiktok/app/v3/fetchliveroominfo" to get the live room information. - Step 3: Use the JSONPATH in the JSON data returned in the second step to get the value of the field $.data.data.owner.idstr as the anchor id (authorid). ### Return: - Live room product list data # [示例/Example] roomid = "7420741353250507562" authorid = "7408859677050274859" page_size = 15 offset = 0

[中文] ### 用途: - 获取直播间商品列表数据 V2 ### 参数: - roomid: 直播间id，必填参数。 - authorid: 主播id，必填参数。 - pagesize: 每页数量，可选参数，默认为15。 - offset: 翻页游标，可选参数，默认为0，每次翻页增加15。 - region: 地区，可选参数，默认为US，如果使用其他地区，如：VN，请自行携带Cookie，否则无法获取数据。 - cookie: 用户自己的cookie，可选参数，用于爬取除US以外的地区数据。 ### 参数获取: - 第一步：使用接口f"{TikHubDomain}/api/v1/tiktok/web/getliveroomid"接口获取直播间id（roomid）。 - 第二步：使用接口f"{TikHubDomain}/api/v1/tiktok/app/v3/fetchliveroominfo"接口获取直播间信息。 - 第三步：使用第二步返回的JSON数据中使用JSONPATH获取$.data.data.owner.idstr字段的值作为主播id（authorid）。 ### 返回: - 直播间商品列表数据 # [English] ### Purpose: - Get live room product list data V2 ### Parameters: - roomid: Live room id, required parameter. - authorid: Anchor id, required parameter. - pagesize: Number per page, optional parameter, default is 15. - offset: Page turning cursor, optional parameter, default is 0, increasing by 15 each time. - region: Region, optional parameter, default is US, if you use other regions, such as: VN, please bring your own Cookie, otherwise you will not be able to get data. - cookie: User's own cookie, optional parameter, used to crawl data from regions other than US. ### Get Parameters: - Step 1: Use the interface f"{TikHubDomain}/api/v1/tiktok/web/getliveroomid" to get the live room id (roomid). - Step 2: Use the interface f"{TikHubDomain}/api/v1/tiktok/app/v3/fetchliveroominfo" to get the live room information. - Step 3: Use the JSONPATH in the JSON data returned in the second step to get the value of the field $.data.data.owner.idstr as the anchor id (authorid). ### Return: - Live room product list data # [示例/Example] roomid = "7420741353250507562" authorid = "7408859677050274859" page_size = 15 offset = 0

[中文] ### 用途: - 根据视频ID来增加作品的播放数 - 该接口默认使用游客Cookie，如果需要使用登录用户的Cookie，请在参数中传入。 - 单一作品每次调用增加1次播放数，请求约 1000 次后会被抖音限制，需要等待一段时间（如：2小时后）后再继续调用。 - 该限制是针对作品的，不是针对接口的，在未登录的情况下，使用不同IP的浏览器或在APP中浏览作品，该作品的播放数也不会增加。 - 可以携带抖音网页端的Cookie来请求此接口，但是不保证一定有效，需要自行测试。 - 上述的限制是根据测试结果得出的，具体限制可能会有所不同，仅供参考。 ### 参数: - awemetype: 作品类型，0:视频 1:图文，可以从单一作品数据接口中获取。 - itemid: 作品id，别名为awemeid - cookie: 可选，默认使用游客Cookie ### 返回: - 当前时间戳和状态码，状态码为200时表示成功，否则为失败，可以尝试更换一个作品id再次调用，或者等待一段时间后再次调用。 # [English] ### Purpose: - Increase the number of plays of the work according to the video ID - This interface uses guest Cookie by default. If you need to use the Cookie of the logged-in user, please pass it in the parameters. - Each call to a single work increases the number of plays by 1. After about 1000 calls, Douyin will restrict it. You need to wait for a period of time (such as 2 hours) before continuing to call. - This restriction is for the work, not for the interface. When browsing the work without logging in, using different IP browsers or browsing the work in the APP, the number of plays of the work will not increase. - You can carry the Cookie of the Douyin web page to request this interface, but it is not guaranteed to be effective and needs to be tested by yourself. - The above restrictions are based on test results, and the specific restrictions may vary, for reference only. ### Parameters: - awemetype: Video type, 0: Video 1: Graphic and text, can be obtained from the single work data interface. - itemid: Video id, alias awemeid - cookie: Optional, use guest Cookie by default ### Return: - The current timestamp and status code. When the status code is 200, it means success, otherwise it is a failure. You can try to change another work id and call it again, or wait for a period of time and call it again. # [示例/Example] awemetype = 0 itemid = "7197598285882789120" cookie = None

[中文] ### 用途: - 获取抖音品牌热榜分类数据 ### 返回: - 品牌热搜榜分类数据 # [English] ### Purpose: - Get Douyin brand hot search category data ### Return: - Hot brand search category data # [示例/Example] pass

[中文] ### 用途: - 获取抖音品牌热榜具体分类数据 ### 参数: - categoryid: 分类id ### 返回: - 品牌热搜榜具体分类数据 # [English] ### Purpose: - Get Douyin brand hot search list detail data ### Parameters: - categoryid: Category id ### Return: - Hot brand search list detail data # [示例/Example] category_id = 10

[中文] ### 用途: - 获取指定话题的详情数据 ### 参数: - chid: 话题id ### 返回: - 话题详情数据 # [English] ### Purpose: - Get details of specified hashtag ### Parameters: - chid: Hashtag id ### Return: - Hashtag details data # [示例/Example] ch_id = 1575791821492238

[中文] ### 用途: - 获取指定话题的作品数据 ### 参数: - chid: 话题id - cursor: 游标，用于翻页，第一页为0，第二页为第一次响应中的cursor值。 - sorttype: 0:综合排序 1:最多点赞 2:最新发布 - count: 数量，请保持默认，否则会出现BUG。 ### 返回: - 话题作品数据 # [English] ### Purpose: - Get video list of specified hashtag ### Parameters: - chid: Hashtag id - cursor: Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response. - sorttype: 0: Comprehensive sorting 1: Most likes 2: Latest release - count: Number Please keep the default, otherwise there will be BUG. ### Return: - Hashtag video list data # [示例/Example] chid = 1575791821492238 cursor = 0 sorttype = 0 count = 10

[中文] ### 用途: - 获取抖音热榜数据，包括： - 热点榜 - 种草榜 - 娱乐榜 - 社会榜 - 挑战榜 ### 参数: - boardtype: - 0: 热点榜（默认） - 2: 其他榜单，如种草榜等，需要传入对应的boardsubtype参数。 - boardsubtype: - 空字符串: 热点榜（默认） - seeding: 种草榜 - 2: 娱乐榜 - 4: 社会榜 - hotspotchallenge: 挑战榜 ### 返回: - 热搜榜数据 # [English] ### Purpose: - Get Douyin hot search list data, including: - Hot search list - Seeding list - Entertainment list - Social list - Challenge list ### Parameters: - boardtype: - 0: Hot search list (default) - 2: Other lists, such as seeding list, etc., need to pass in the corresponding boardsubtype parameter. - boardsubtype: - Empty string: Hot search list (default) - seeding: Seeding list - 2: Entertainment list - 4: Social list - hotspotchallenge: Challenge list ### Return: - Hot search list data # [示例/Example] - 获取热点榜数据 - boardtype = 0 - boardsubtype = "" - 获取种草榜数据 - boardtype = 2 - boardsubtype = "seeding"

[中文] ### 用途: - 获取抖音直播热搜榜数据 ### 返回: - 直播热搜榜数据 # [English] ### Purpose: - Get Douyin live hot search list data ### Return: - Live hot search list data # [示例/Example] pass

[中文] ### 用途: - 获取指定音乐的详情数据 ### 参数: - musicid: 音乐id ### 返回: - 音乐详情数据 # [English] ### Purpose: - Get details of specified music ### Parameters: - musicid: Music id ### Return: - Music details data # [示例/Example] music_id = "7136850194742315016"

[中文] ### 用途: - 获取抖音音乐热榜数据 ### 参数: - charttype: 榜单类型，默认值为'hot'，支持下面的值： - 'hot': 热门榜 - 'trending': 飙升榜 - 'original': 原创榜 - cursor: 游标，默认值为'0'，用于分页获取数据，每次请求后会返回下一个游标值，并且通过 hasmore 字段指示是否有更多数据可供获取。 ### 返回: - 音乐热搜榜数据 # [English] ### Purpose: - Get Douyin music hot search list data ### Parameters: - charttype: Chart type, default value is 'hot', supports the following values: - 'hot': Hot chart - 'trending': Trending chart - 'original': Original chart - cursor: Cursor, default value is '0', used for paginating data retrieval. After each request, the next cursor value will be returned, and the hasmore field indicates whether there is more data available. ### Return: - Music hot search list data # [示例/Example] chart_type = "hot" cursor = "0"

[中文] ### 用途: - 获取指定音乐的视频列表数据 ### 参数: - musicid: 音乐id - cursor: 游标，用于翻页，第一页为0，第二页为第一次响应中的cursor值。 - count: 数量，请保持默认，否则会出现BUG。 ### 返回: - 音乐视频列表数据 # [English] ### Purpose: - Get video list of specified music ### Parameters: - musicid: Music id - cursor: Cursor, used for paging, the first page is 0, the second page is the cursor value in the first response. - count: Number Please keep the default, otherwise there will be BUG. ### Return: - Music video list data # [示例/Example] music_id = "7136850194742315016" cursor = 0 count = 10

[中文] ### 用途: - 获取单个作品数据，支持图文、视频等。 ### 参数: - awemeid: 作品id ### 返回: - 作品数据 ### 备注: - 如果接口出现返回空的情况，请使用一样的参数去请求 Web 版本接口，具体响应状态码参考： - JSON PATH: $.data.filterlist[0].reason - 8：该内容因海外版权限制，暂时无法观看（短剧，电影片段等） - 8：视频不存在或已被删除 - 5：该内容被标记为私人内容，没有公开展示权限 - 10：该内容被标记为部分可见，仅作者选择的部分用户可见 - 更多状态码请提交给我们的客户支持进行补充。 # [English] ### Purpose: - Get single video data, support photo, video, etc. ### Parameters: - awemeid: Video id ### Return: - Video data ### Note: - If the interface returns empty, please use the same parameters to request the Web version interface. The specific response status code refers to: - JSON PATH: $.data.filterlist[0].reason - 8: This content is temporarily unavailable for viewing due to overseas copyright restrictions (short dramas, movie clips, etc.) - 8: The video does not exist or has been deleted - 5: This content is marked as private content and does not have public display permissions - 10: This content is marked as partially visible, only visible to some users chosen by the author - For more status codes, please submit them to our customer support for supplementation. # [示例/Example] aweme_id = "7448118827402972455"

[中文] ### 用途: - 根据分享链接获取单个作品数据 ### 参数: - shareurl: 分享链接 ### 返回: - 作品数据 ### 备注: - 如果接口出现返回空的情况，请使用一样的参数去请求 Web 版本接口，具体响应状态码参考： - JSON PATH: $.data.filterlist[0].reason - 8：该内容因海外版权限制，暂时无法观看（短剧，电影片段等） - 8：视频不存在或已被删除 - 5：该内容被标记为私人内容，没有公开展示权限 - 10：该内容被标记为部分可见，仅作者选择的部分用户可见 - 更多状态码请提交给我们的客户支持进行补充。 # [English] ### Purpose: - Get single video data by sharing link ### Parameters: - shareurl: Share link ### Return: - Video data ### Note: - If the interface returns empty, please use the same parameters to request the Web version interface. The specific response status code refers to: - JSON PATH: $.data.filterlist[0].reason - 8: This content is temporarily unavailable for viewing due to overseas copyright restrictions (short dramas, movie clips, etc.) - 8: The video does not exist or has been deleted - 5: This content is marked as private content and does not have public display permissions - 10: This content is marked as partially visible, only visible to some users chosen by the author - For more status codes, please submit them to our customer support for supplementation. # [示例/Example] share_url = "https://v.douyin.com/e3x2fjE/"

[中文] ### 用途: - 获取单个作品数据，支持图文、视频等。 ### 参数: - awemeid: 作品id ### 返回: - 作品数据 ### 备注: - 如果接口出现返回空的情况，请使用一样的参数去请求 Web 版本接口，具体响应状态码参考： - JSON PATH: $.data.filterlist[0].reason - 8：该内容因海外版权限制，暂时无法观看（短剧，电影片段等） - 8：视频不存在或已被删除 - 5：该内容被标记为私人内容，没有公开展示权限 - 10：该内容被标记为部分可见，仅作者选择的部分用户可见 - 更多状态码请提交给我们的客户支持进行补充。 # [English] ### Purpose: - Get single video data, support photo, video, etc. ### Parameters: - awemeid: Video id ### Return: - Video data ### Note: - If the interface returns empty, please use the same parameters to request the Web version interface. The specific response status code refers to: - JSON PATH: $.data.filterlist[0].reason - 8: This content is temporarily unavailable for viewing due to overseas copyright restrictions (short dramas, movie clips, etc.) - 8: The video does not exist or has been deleted - 5: This content is marked as private content and does not have public display permissions - 10: This content is marked as partially visible, only visible to some users chosen by the author - For more status codes, please submit them to our customer support for supplementation. # [示例/Example] aweme_id = "7448118827402972455"

[中文] ### 用途: - 获取单个作品数据，支持文章、图文、视频等。 - V3版本的接口，解决了版权限制问题，可以获取更多受限内容，比如 V1，V2版本返回的Reason为8的内容和部分文章或短剧等。 ### 参数: - awemeid: 作品id ### 返回: - 作品数据 # [English] ### Purpose: - Get single video data, support article, photo, video, etc. - V3 version of the interface, which solves the copyright restriction problem and can obtain more restricted content, such as content with Reason 8 returned by V1 and V2 versions and some articles or short dramas. ### Parameters: - awemeid: Video id ### Return: - Video data # [示例/Example] aweme_id = "7592116912205630761"