[中文]

用途:

获取符合条件的创作者列表，包括粉丝数、互动率等数据

发现高质量的广告合作创作者

分析不同类型创作者的表现和特点

参数:

page: 页码，默认1

limit: 每页数量，默认20

sort_by: 排序方式

follower: 按粉丝数排序

engagement: 按互动率排序

avg_views: 按平均观看量排序

creator_country: 创作者所在国家

audience_country: 受众所在国家（可选）

audience_count: 受众数量筛选（可选）

返回内容说明:

creators: 创作者列表

tcm_id: TCM ID

user_id: 用户ID

nick_name: 昵称

avatar_url: 头像URL

country_code: 国家代码

follower_cnt: 粉丝数

liked_cnt: 获赞总数

tt_link: TikTok链接

tcm_link: TCM链接

items: 作品列表

item_id: 作品ID

cover_url: 封面URL

tt_link: TikTok链接

vv: 观看量

liked_cnt: 点赞数

create_time: 创建时间

pagination: 分页信息

page: 当前页

size: 每页数量

total: 总数量

has_more: 是否有更多

示例响应:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_creator_list",
  "params": {
    "page": "1",
    "limit": "20",
    "sort_by": "follower",
    "creator_country": "US",
    "audience_country": "",
    "audience_count": "0"
  },
  "data": {
    "code": 0,
    "msg": "OK",
    "data": {
      "creators": [
        {
          "tcm_id": "7414477993612935173",
          "user_id": "62133858422239232",
          "nick_name": "Fernanda",
          "avatar_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/200b649d30f76f1238d771f4aff51ee1~tplv-tiktokx-cropcenter:100:100.png",
          "country_code": "US",
          "follower_cnt": 9135515,
          "liked_cnt": 668294555,
          "tt_link": "https://www.tiktok.com/@ferchugimenez",
          "tcm_link": "https://creatormarketplace.tiktok.com/ad#/author/7414477993612935173",
          "items": [
            {
              "item_id": "7444674312784645432",
              "cover_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/oQIBhn2EeBMUWQR5wVQACFEBtlDxgUDdAfoB8J~tplv-noop.image",
              "tt_link": "https://www.tiktok.com/@author/video/7444674312784645432",
              "vv": 13733332,
              "liked_cnt": 516217,
              "create_time": 1733348322
            }
          ]
        }
      ],
      "pagination": {
        "page": 1,
        "size": 20,
        "total": 459,
        "has_more": true
      }
    }
  }
}

[English]

Purpose:

Get a list of creators matching criteria, including follower count, engagement rate, etc.

Discover high-quality creators for ad collaboration

Analyze performance and characteristics of different creator types

Parameters:

page: Page number, default 1

limit: Items per page, default 20

sort_by: Sorting method

follower: Sort by follower count

engagement: Sort by engagement rate

avg_views: Sort by average views

creator_country: Creator's country

audience_country: Audience country (optional)

audience_count: Audience count filter (optional)

Return Description:

creators: Creator list

tcm_id: TikTok Creator Marketplace ID

user_id: User ID

nick_name: Nickname

avatar_url: Avatar URL

country_code: Country code

follower_cnt: Follower count

liked_cnt: Total likes count

tt_link: TikTok profile link

tcm_link: Creator marketplace link

items: Video list

item_id: Video ID

cover_url: Cover image URL

tt_link: Video link

vv: View count

liked_cnt: Like count

create_time: Creation timestamp

pagination: Pagination info

page: Current page

size: Items per page

total: Total count

has_more: Has more pages

Example Response:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_creator_list",
  "params": {
    "page": "1",
    "limit": "20",
    "sort_by": "follower",
    "creator_country": "US",
    "audience_country": "",
    "audience_count": "0"
  },
  "data": {
    "code": 0,
    "msg": "OK",
    "data": {
      "creators": [
        {
          "tcm_id": "7414477993612935173",
          "user_id": "62133858422239232",
          "nick_name": "Fernanda",
          "avatar_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/200b649d30f76f1238d771f4aff51ee1~tplv-tiktokx-cropcenter:100:100.png",
          "country_code": "US",
          "follower_cnt": 9135515,
          "liked_cnt": 668294555,
          "tt_link": "https://www.tiktok.com/@ferchugimenez",
          "tcm_link": "https://creatormarketplace.tiktok.com/ad#/author/7414477993612935173",
          "items": [
            {
              "item_id": "7444674312784645432",
              "cover_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/oQIBhn2EeBMUWQR5wVQACFEBtlDxgUDdAfoB8J~tplv-noop.image",
              "tt_link": "https://www.tiktok.com/@author/video/7444674312784645432",
              "vv": 13733332,
              "liked_cnt": 516217,
              "create_time": 1733348322
            }
          ]
        }
      ],
      "pagination": {
        "page": 1,
        "size": 20,
        "total": 459,
        "has_more": true
      }
    }
  }
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

page

integer

Page

optional

页码/Page number

Default:

limit

integer

Limit

optional

每页数量/Items per page

Default:

sort_by

string

Sort By

optional

排序方式/Sort by (follower, engagement, avg_views)

Default:

follower

creator_country

string

Creator Country

optional

创作者国家/Creator country

Default:

audience_country

string

Audience Country

optional

受众国家/Audience country

Default:

audience_count

integer

Audience Count

optional

受众数量筛选/Audience count filter

Default:

keyword

string

Keyword

optional

关键词/Keyword

Responses

🟢200OK

application/json

Successful Response

Body

code

integer

Code

optional

HTTP status code | HTTP状态码

Default:

200

router

string

Router

optional

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

Default:

params

Params

optional

The parameters used in the request | 请求中使用的参数

Default:

{}

data

Data

optional

The response data | 响应数据

Any of

null

Example

{
    "code": 200,
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

获取创作者列表/Get creator list

[中文]

用途:

参数:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Return Description:

Example Response:

Request

Request samples

Responses

获取创作者列表/Get creator list

[中文]#

用途:#

参数:#

返回内容说明:#

示例响应:#

[English]#

Purpose:#

Parameters:#

Return Description:#

Example Response:#

Request

Request samples

Responses

[中文]

用途:

参数:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Return Description:

Example Response: