[中文]

用途:

通过关键词搜索创作者

快速找到特定领域或名称的创作者

支持按粉丝数或平均观看量排序

参数:

keyword: 搜索关键词，可以是用户名、昵称的一部分

page: 页码，默认1

limit: 每页数量，默认20

sort_by: 排序方式

follower: 按粉丝数排序

avg_views: 按平均观看量排序

creator_country: 创作者所在国家

返回内容说明:

creators: 创作者列表

tcm_id: 创作者市场ID

user_id: 用户ID

nick_name: 昵称

avatar_url: 头像URL

country_code: 国家代码

follower_cnt: 粉丝数

liked_cnt: 总点赞数

tt_link: TikTok个人主页链接

tcm_link: 创作者市场链接

items: 作品列表

item_id: 作品ID

cover_url: 封面URL

tt_link: 作品链接

vv: 观看量

liked_cnt: 点赞数

create_time: 创建时间戳

pagination: 分页信息

page: 当前页码

size: 每页数量

total: 总数

has_more: 是否有更多

示例响应:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/search_creators",
  "params": {
    "keyword": "jo",
    "page": "1",
    "limit": "20",
    "sort_by": "follower",
    "creator_country": "US"
  },
  "data": {
    "code": 0,
    "msg": "OK",
    "data": {
      "creators": [
        {
          "tcm_id": "6894787532572065797",
          "user_id": "6684747467718820870",
          "nick_name": "Josh Zilberberg",
          "avatar_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f11c960c637601225c29d6e7849069eb~tplv-tiktokx-cropcenter:100:100.png",
          "country_code": "US",
          "follower_cnt": 3048368,
          "liked_cnt": 130131619,
          "tt_link": "https://www.tiktok.com/@josh.zilberberg",
          "tcm_link": "https://creatormarketplace.tiktok.com/ad#/author/6894787532572065797",
          "items": [
            {
              "item_id": "7406005139112283397",
              "cover_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/6e0c79311c2b49758674ae64721c495b_1724344961~tplv-noop.image",
              "tt_link": "https://www.tiktok.com/@author/video/7406005139112283397",
              "vv": 3266905,
              "liked_cnt": 4057,
              "create_time": 1724344950
            }
          ]
        }
      ],
      "pagination": {
        "page": 1,
        "size": 20,
        "total": 6,
        "has_more": false
      }
    }
  }
}

[English]

Purpose:

Search creators by keyword

Quickly find creators in specific fields or with specific names

Support sorting by follower count or average views

Parameters:

keyword: Search keyword, can be part of username or nickname

page: Page number, default 1

limit: Items per page, default 20

sort_by: Sorting method

follower: Sort by follower count

avg_views: Sort by average views

creator_country: Creator's country

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/search_creators",
  "params": {
    "keyword": "jo",
    "page": "1",
    "limit": "20",
    "sort_by": "follower",
    "creator_country": "US"
  },
  "data": {
    "code": 0,
    "msg": "OK",
    "data": {
      "creators": [
        {
          "tcm_id": "6894787532572065797",
          "user_id": "6684747467718820870",
          "nick_name": "Josh Zilberberg",
          "avatar_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f11c960c637601225c29d6e7849069eb~tplv-tiktokx-cropcenter:100:100.png",
          "country_code": "US",
          "follower_cnt": 3048368,
          "liked_cnt": 130131619,
          "tt_link": "https://www.tiktok.com/@josh.zilberberg",
          "tcm_link": "https://creatormarketplace.tiktok.com/ad#/author/6894787532572065797",
          "items": [
            {
              "item_id": "7406005139112283397",
              "cover_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/6e0c79311c2b49758674ae64721c495b_1724344961~tplv-noop.image",
              "tt_link": "https://www.tiktok.com/@author/video/7406005139112283397",
              "vv": 3266905,
              "liked_cnt": 4057,
              "create_time": 1724344950
            }
          ]
        }
      ],
      "pagination": {
        "page": 1,
        "size": 20,
        "total": 6,
        "has_more": false
      }
    }
  }
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

keyword

string

Keyword

required

搜索关键词/Search keyword

Example:

page

integer

Page

optional

页码/Page number

Default:

limit

integer

Limit

optional

每页数量/Items per page

Default:

sort_by

string

Sort By

optional

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

Default:

follower

creator_country

string

Creator Country

optional

创作者国家/Creator country

Default:

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

搜索创作者/Search creators

[中文]

用途:

参数:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Return Description:

Example Response:

Request

Request samples

Responses

搜索创作者/Search creators

[中文]#

用途:#

参数:#

返回内容说明:#

示例响应:#

[English]#

Purpose:#

Parameters:#

Return Description:#

Example Response:#

Request

Request samples

Responses

[中文]

用途:

参数:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Return Description:

Example Response: