---
title: "批量获取创作者卡片/Get creators card"
method: POST
path: "/api/v1/tiktok/ads/get_creators_card"
tags: ["TikTok-Ads-API"]
---

# 批量获取创作者卡片/Get creators card

`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)
- URL: `https://api.tikhub.io/api/v1/tiktok/ads/get_creators_card`
- Auth: HTTP bearer

# [中文]
### 用途:
- 批量获取创作者卡片数据，包含粉丝画像、粉丝增长、整体表现与近期作品
- 可与热门视频榜单配合使用，分析上榜视频背后的创作者

### 参数:
- 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来获取更多数据

### 请求示例:
```json
{
    "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:
```json
{
    "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)

## Request body

- BodyGetCreatorsCardApiV1TiktokAdsGetCreatorsCardPost
  - `tt_uids` string[]: 创作者ID列表/Creator ID list
  - `need_loader_list` integer[]: 需要返回的数据模块编号，空为全部/Data module IDs, empty for all
  - `creator_type` integer: 创作者类型/Creator type
  - `cookie` string: 自定义Cookie字符串（可选）/Custom Cookie string (optional)

## Response `200`

Successful Response

- ResponseModel
  - `code` integer: HTTP status code | HTTP状态码
  - `request_id` string, nullable: Unique request identifier | 唯一请求标识符
  - `message` string: Response message (EN-US) | 响应消息 (English)
  - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文)
  - `support` string: Support message | 支持消息
  - `time` string: The time the response was generated | 生成响应的时间
  - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳
  - `time_zone` string: The timezone of the response time | 响应时间的时区
  - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接
  - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English)
  - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文)
  - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL
  - `router` string: The endpoint that generated this response | 生成此响应的端点
  - `params` unknown
  - `data` unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-08** `96a122a5f220`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-09-01** `50f9ec6e1cd3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/tiktok/ads/get_creators_card/post.md)

---

[API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)