TikTok-Ads-API
批量获取创作者卡片/Get creators card
Changed on[中文]
用途:
- 批量获取创作者卡片数据,包含粉丝画像、粉丝增长、整体表现与近期作品
- 可与热门视频榜单配合使用,分析上榜视频背后的创作者
参数:
- tt_uids: 创作者ID列表,从 /get_top_contents_list 返回的 itemInfo.creatorID 获取,支持一次传多个
- need_loader_list: 需要返回的数据模块编号列表,不传则返回全部。可选值:
- 101: 创作者基础信息
- 102: 报价与价格指数
- 103: 创作者基础信息
- 104: 数据统计(受众画像/粉丝趋势/整体表现/视频表现)
- 105: 近期作品
- 106: 创作者市场状态
- 107: 内容分类标签
- 125: 创作者类型与展示信息
- creator_type: 创作者类型,默认2
- cookie: 自定义Cookie字符串,可选参数,可以使用自己的Cookie来获取更多数据
请求示例:
{
"tt_uids": ["103641138313531392"],
"need_loader_list": [101, 104, 105],
"creator_type": 2
}
返回内容说明:
- creators: 创作者卡片列表,返回字段随 need_loader_list 变化,常见:
- ttUID: 创作者ID
- creatorTTInfo: 昵称、handle、头像、粉丝数、简介、地区
- statisticData: 受众画像(age / gender / region / deviceBrand)、粉丝增长曲线、整体表现(互动率/播放中位数及其排名)、视频表现
- recentItems: 近期作品 (itemID / title / views / heart / comment / share / coverURL / videoURL)
- contentLabels: 内容分类标签
- creatorProfile / priceIndex / esData: 报价与创作者市场状态
[English]
Purpose:
- Batch fetch creator cards including audience profile, follower growth, overall performance and recent posts
- Pairs with the Top Contents ranking to analyze the creators behind trending videos
Parameters:
- tt_uids: Creator ID list, obtained from itemInfo.creatorID of /get_top_contents_list, multiple IDs allowed
- need_loader_list: Data module IDs to return, omit for all. Options:
- 101: Creator basic info
- 102: Quote and price index
- 103: Creator basic info
- 104: Statistics (audience profile / follower trend / overall performance / video performance)
- 105: Recent posts
- 106: Creator marketplace status
- 107: Content labels
- 125: Creator type and display info
- creator_type: Creator type, default 2
- cookie: Custom Cookie string, optional parameter, you can use your own Cookie to get more data
Request Example:
{
"tt_uids": ["103641138313531392"],
"need_loader_list": [101, 104, 105],
"creator_type": 2
}
Return Description:
- creators: Creator card list; returned fields depend on need_loader_list (ttUID / creatorTTInfo / statisticData / recentItems / contentLabels / creatorProfile / priceIndex / esData)
post/api/v1/tiktok/ads/get_creators_card
Request
- Base URLhttps://api.tikhub.io (the document declares no server; this is the origin it was published from)
- AuthHTTP bearer
Request body
Example request
{
"need_loader_list": [
101,
102,
103,
104,
105,
106,
107,
125
]
}Response
Successful Response
Changes
- info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status
- info
- info
endpoint added
- info