[中文]

用途:

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

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

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

参数:

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
      }
    }
  }
}

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Unprocessable Entity

获取创作者列表/Get creator list

[中文]#

用途:#

参数:#

返回内容说明:#

示例响应:#

[English]#

Purpose:#

Parameters:#

Return Description:#

Example Response:#

Request