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 URL
    https://api.tikhub.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Request body

tt_uidsstring[]

创作者ID列表/Creator ID list

need_loader_listinteger[]

需要返回的数据模块编号,空为全部/Data module IDs, empty for all

creator_typeinteger

创作者类型/Creator type

cookiestring

自定义Cookie字符串(可选)/Custom Cookie string (optional)

Example request

{
  "need_loader_list": [
    101,
    102,
    103,
    104,
    105,
    106,
    107,
    125
  ]
}

Response

Successful Response

codeinteger

HTTP status code | HTTP状态码

request_idstring nullable

Unique request identifier | 唯一请求标识符

messagestring

Response message (EN-US) | 响应消息 (English)

message_zhstring

Response message (ZH-CN) | 响应消息 (中文)

supportstring

Support message | 支持消息

timestring

The time the response was generated | 生成响应的时间

time_stampinteger

The timestamp the response was generated | 生成响应的时间戳

time_zonestring

The timezone of the response time | 响应时间的时区

docsstring nullable

Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接

cache_messagestring nullable

Cache message (EN-US) | 缓存消息 (English)

cache_message_zhstring nullable

Cache message (ZH-CN) | 缓存消息 (中文)

cache_urlstring nullable

The URL to access the cached result | 访问缓存结果的 URL

routerstring

The endpoint that generated this response | 生成此响应的端点

paramsunknown
dataunknown

Changes