TikTok API endpoint

Retrieve TikTok popular-trend hashtags

Returns trending hashtags from TikTok Creative Center. The service clamps `page` to 1-10, `limit` to at most 100, and defaults `period` to 7.

GETapiKey8 credits/requestpopulartrend.hashtagTrendResponseDoc/tiktok/popular-trend/hashtag

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	Number of results per page
period	query	integer	No	7, 30, 120		Trend window in days
industry_id	query	integer	No			Industry ID to filter trends
country_code	query	string	No		US	Country code filter
filter_by	query	string	No			Filter criteria, only 'new_on_board' is allowed

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

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": {
      "list": [
        {
          "hashtag_id": "4777",
          "hashtag_name": "prom",
          "country_info": {
            "id": "US",
            "value": "United States",
            "label": "US"
          },
          "industry_info": {
            "id": 22000000000,
            "value": "Apparel & Accessories",
            "label": "label_22000000000"
          },
          "is_promoted": false,
          "trend": [
            {
              "time": 1776729600,
              "value": 1
            }
          ],
          "publish_cnt": 179872,
          "video_views": 766182036,
          "rank": 1,
          "rank_diff": 0,
          "rank_diff_type": 4
        }
      ],
      "pagination": {
        "page": 1,
        "size": 1,
        "total": 100,
        "has_more": true
      }
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/populartrend.hashtagTrendResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	popularTrend.HashtagTrendResp	No
data.code	integer	No
data.data	object	No
data.data.list	array	No
data.data.list[].country_info	object	No
data.data.list[].country_info.id	string	No
data.data.list[].country_info.label	string	No
data.data.list[].country_info.value	string	No
data.data.list[].creators	array	No
data.data.list[].creators[].avatar_url	string	No
data.data.list[].creators[].nick_name	string	No
data.data.list[].hashtag_id	string	No
data.data.list[].hashtag_name	string	No
data.data.list[].industry_info	object	No
data.data.list[].industry_info.id	integer	No
data.data.list[].industry_info.label	string	No
data.data.list[].industry_info.value	string	No
data.data.list[].is_promoted	boolean	No
data.data.list[].publish_cnt	integer	No
data.data.list[].rank	integer	No
data.data.list[].rank_diff	integer	No
data.data.list[].rank_diff_type	integer	No
data.data.list[].trend	array	No
data.data.list[].trend[].time	integer	No
data.data.list[].trend[].value	number	No
data.data.list[].video_views	integer	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/hashtag?limit=50&country_code=US" -H "x-api-key: <api-key>"

TypeScript fetch

const url = new URL("https://api.crawlora.net/api/v1/tiktok/popular-trend/hashtag");
url.searchParams.set("limit", "50");
url.searchParams.set("country_code", "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