Skip to main content
GET
/
v1
/
tiktok
/
trending
/
hashtags
cURL
curl --request GET \
  --url 'https://api.keyapi.ai/v1/tiktok/trending/hashtags?page=1&limit=20&period=7&region=all_regions&industry_id=nothing&new_to_top_100=false' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'
{
  "code": 0,
  "message": "success",
  "data": {
    "list": [
      {
        "hashtag_id": "7244",
        "hashtag_name": "clean",
        "country_info": {
          "id": "US",
          "value": "United States",
          "label": "US"
        },
        "industry_info": {
          "id": 11000000000,
          "value": "Vehicle & Transportation",
          "label": "label_11000000000"
        },
        "is_promoted": false,
        "trend": [
          {
            "time": 1769472000,
            "value": 0.96
          },
          {
            "time": 1769558400,
            "value": 0.91
          },
          {
            "time": 1769644800,
            "value": 0.87
          },
          {
            "time": 1769731200,
            "value": 0.83
          },
          {
            "time": 1769817600,
            "value": 0.84
          },
          {
            "time": 1769904000,
            "value": 0.96
          },
          {
            "time": 1769990400,
            "value": 1
          }
        ],
        "creators": [
          {
            "nick_name": "becky mae",
            "avatar_url": "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/71fc1185244765128518537b9d9c210d~tplv-tiktokx-cropcenter:100:100.png?dr=14579&refresh_token=0dec4860&x-expires=1770282000&x-signature=r%2BCrhZzsKS43L89YylY1uge6L2M%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=317596d8&idc=my"
          },
          {
            "nick_name": "Galicia Gordon",
            "avatar_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/a83d99ecd4e1859d1f3a122eaafa7141~tplv-tiktokx-cropcenter:100:100.png?dr=14579&refresh_token=7237e421&x-expires=1770282000&x-signature=VYRz0YUvi03Jl3xRNAyOK2BdVmg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=317596d8&idc=my"
          },
          {
            "nick_name": "micaelarosa_",
            "avatar_url": "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/e1336ed62aab40b9ae1acbf487b6ccf9~tplv-tiktokx-cropcenter:100:100.png?dr=14579&refresh_token=6ea3e036&x-expires=1770282000&x-signature=LXT1FUefFvU1xYkoOPnuBBV46A8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=317596d8&idc=my"
          }
        ],
        "publish_cnt": 48892,
        "video_views": 151854088,
        "rank": 1,
        "rank_diff_type": 4
      }
    ],
    "pagination": {
      "page": 1,
      "size": 1,
      "total": 100,
      "has_more": true
    }
  },
  "requestId": "c2aaf374-bc6f-4cd6-9e82-9b0c38269f43"
}
🪙2 creditsper request

​
Copy for AI

🤖 Why Code When AI Can Do It For You?

Stop writing code like it’s 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.

Authorizations

​
Authorization
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx Get your API key from the Dashboard.

Query Parameters

​
page
string
default:1

Pagination page number, default is 1

Example:

"1"

​
limit
string
default:20

The number of data items per page in pagination, which is used to specify the maximum number of results returned by a single query. The value range is 1 to 20. If it exceeds the maximum value, it will be automatically handled as 20.

Example:

"20"

​
period
string
default:7

The time range for querying data. Optional valid values: 7 (last 7 days), 30 (last 30 days), 120 (last 120 days)

Example:

"7"

​
region
string
default:all_regions

Country/region code, the default value "all_regions" represents all regions, example: US

Example:

"all_regions"

​
industry_id
string
default:nothing

First-level industry filtering identifier, used to limit the scope of first-level industries for querying data. The default value "nothing" means no industry filtering is applied. The first-level industry ID can be obtained from the "Industry Classification Mapping".

Example:

"nothing"

​
new_to_top_100
string
default:false

Whether to filter hot topics that enter the top 100 for the first time. Optional values: false (no, do not filter), true (yes, only filter hot topics that enter the top 100 for the first time)

Example:

"false"

Response

Success

The response is of type object.