TikTok API endpoint

Retrieve TikTok popular-trend creators

Returns trending creators from TikTok Creative Center. The service clamps `page` to 1-10 and `limit` to at most 100.

GETapiKey8 credits/requestpopulartrend.creatorTrendResponseDoc/tiktok/popular-trend/creator

Parameters

Name	In	Type	Required	Enum	Example	Description
x-api-key	header	string	Yes			API key required
page	query	integer	No			Page number
limit	query	integer	No		50	Maximum number of creators to return
sort_by	query	string	No	follower, engagement, avg_views		Sort order
creator_country	query	string	No		US	Creator country code
audience_count	query	integer	No	1, 2, 3, 4		Accepted for compatibility but currently ignored by the upstream request

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost: 8 credits/request
Charged response: Successful 2xx responses

Plan	Price	Included credits	Daily cap	Rate limit	Overage
Free	$0/mo	2,000	500 daily credits	5/min	No overage
Starter	$9/mo	20,000	5,000 daily credits	15/min	$0.75/1,000 overage credits when enabled
Growth	$29/mo	100,000	25,000 daily credits	45/min	$0.45/1,000 overage credits when enabled
Pro	$79/mo	400,000	No daily cap	120/min	$0.30/1,000 overage credits
Business	$199/mo	1,200,000	No daily cap	300/min	$0.20/1,000 overage credits
Enterprise	$499/mo	5,000,000	No daily cap	1,000/min	$0.12/1,000 overage credits

Response behavior

- `audience_count` is accepted for compatibility, but the current upstream request does not apply it. Example response: ```json { "code": 200, "msg": "OK", "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/3fa0e612da6c7528e77ef65fbb...", "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/oQIBhn2EeBMUWQR5wVQACFEBtlDx...", "tt_link": "https://www.tiktok.com/@author/video/7444674312784645432", "vv": 13733332, "liked_cnt": 516217, "create_time": 1733348322 } ] } ], "pagination": { "page": 1, "size": 1, "total": 459, "has_more": true } } } } ```

Failure responses

Status	Description	Schema
400	Invalid input	#/definitions/app.Response
429	Rate limit exceeded	#/definitions/app.Response
500	Internal server error	#/definitions/app.Response

Example response

{
  "code": 200,
  "msg": "OK",
  "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/3fa0e612da6c7528e77ef65fbb...",
          "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/oQIBhn2EeBMUWQR5wVQACFEBtlDx...",
              "tt_link": "https://www.tiktok.com/@author/video/7444674312784645432",
              "vv": 13733332,
              "liked_cnt": 516217,
              "create_time": 1733348322
            }
          ]
        }
      ],
      "pagination": {
        "page": 1,
        "size": 1,
        "total": 459,
        "has_more": true
      }
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/populartrend.creatorTrendResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	popularTrend.CreatorTrendResp	No
data.code	integer	No
data.data	object	No
data.data.creators	array	No
data.data.creators[].avatar_url	string	No
data.data.creators[].country_code	string	No
data.data.creators[].follower_cnt	integer	No
data.data.creators[].items	array	No
data.data.creators[].items[].cover_url	string	No
data.data.creators[].items[].create_time	integer	No
data.data.creators[].items[].item_id	string	No
data.data.creators[].items[].liked_cnt	integer	No
data.data.creators[].items[].tt_link	string	No
data.data.creators[].items[].vv	integer	No
data.data.creators[].liked_cnt	integer	No
data.data.creators[].nick_name	string	No
data.data.creators[].tcm_id	string	No
data.data.creators[].tcm_link	string	No
data.data.creators[].tt_link	string	No
data.data.creators[].user_id	string	No
data.data.pagination	object	No
data.data.pagination.has_more	boolean	No
data.data.pagination.page	integer	No
data.data.pagination.size	integer	No
data.data.pagination.total	integer	No
data.msg	string	No
data.request_id	string	No
msg	string	No	OK

Example request

curl -X GET "https://api.crawlora.net/api/v1/tiktok/popular-trend/creator?limit=50&creator_country=US" -H "x-api-key: <api-key>"

TypeScript fetch

const url = new URL("https://api.crawlora.net/api/v1/tiktok/popular-trend/creator");
url.searchParams.set("limit", "50");
url.searchParams.set("creator_country", "US");
const headers = new Headers();
headers.set("x-api-key", "<api-key>");
const response = await fetch(url, {
  method: "GET",
  headers,
});
const payload = await response.json();

Open in Playground Back to group