> ## Documentation Index > Fetch the complete documentation index at: https://docs.keyapi.ai/llms.txt > Use this file to discover all available pages before exploring further. # 热门 Hashtag > 获取 TikTok 当前热门 Hashtag 列表，包括视频数量和增长指标。
🪙 2 credits每次请求
## Copy for AI

🤖 让 AI 帮你写调用代码

点击按钮复制一段结构化提示词，可直接交给 ChatGPT、Claude 或其他 AI 助手生成接口调用代码。

## OpenAPI ````yaml zh/tiktok.zh.openapi.json GET /v1/tiktok/trending/hashtags openapi: 3.0.1 info: title: Tiktok API 中文文档 description: Tiktok API 的中文参考文档，包含接口用途、参数说明、响应状态和示例结构。 version: 1.0.0 servers: - url: https://api.keyapi.ai description: Production security: [] tags: - name: TikTok Influencer - name: TikTok Shop Creator - name: TikTok Shop - name: TikTok Content - name: TikTok Intelligence paths: /v1/tiktok/trending/hashtags: get: tags: - TikTok 趋势洞察 summary: 热门 Hashtag description: 获取 TikTok 当前热门 Hashtag 列表，包括视频数量和增长指标。 operationId: get_api_v3_realtime_trending_popular_hashtag_list parameters: - name: page in: query description: 分页页码，默认值为 1。 required: false schema: type: string example: '1' default: '1' example: '1' - name: limit in: query description: 每页返回数量，取值范围 1 到 20；超过最大值时会按 20 处理。 required: false schema: type: string example: '20' default: '20' example: '20' - name: period in: query description: 查询时间范围，可选值：7=近 7 天，30=近 30 天，120=近 120 天。 required: false schema: type: string example: '7' default: '7' example: '7' - name: region in: query description: 国家/地区代码；默认值 all_regions 表示全部地区，例如 US。 required: false schema: type: string example: all_regions default: all_regions example: all_regions - name: industry_id in: query description: 一级行业筛选 ID，用于限制查询的行业范围；默认值 nothing 表示不筛选行业，可从“行业分类映射”获取。 required: false schema: type: string example: nothing default: nothing example: nothing - name: new_to_top_100 in: query description: 是否仅筛选首次进入 Top 100 的热门话题；false=不筛选，true=仅筛选首次进入 Top 100 的话题。 required: false schema: type: string example: 'false' default: 'false' example: 'false' responses: '200': description: 请求成功 content: application/json: schema: type: object properties: {} example: 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 '400': description: 请求参数错误，请检查必填字段和参数格式 content: application/json: schema: type: object example: code: 400 data: null message: 'Missing required parameter: handle' '401': description: 鉴权失败，请检查 Authorization Header 中的 Bearer Token 或 API Key 是否有效 content: application/json: schema: type: object example: code: 401 data: null message: apiKey is null '402': description: 账户余额或额度不足 content: application/json: schema: type: object example: code: 402 data: null message: apiKey quota is not enough '429': description: 请求过于频繁，已触发限流 content: application/json: schema: type: object example: code: 429 data: null message: qps limit exceeded '500': description: 服务器内部错误，请稍后重试 content: application/json: schema: type: object example: code: 500 data: null message: Internal server error deprecated: false security: - JWT Bearer: [] x-codeSamples: - lang: curl label: cURL source: |- curl --request GET \ --url 'https://api.keyapi.ai/v1/tiktok/trending/hashtags?page=1&limit=20&period=7®ion=all_regions&industry_id=nothing&new_to_top_100=false' \ --header 'Authorization: Bearer ' - lang: python label: Python source: |- import requests response = requests.get( 'https://api.keyapi.ai/v1/tiktok/trending/hashtags', params={"page": "1", "limit": "20", "period": "7", "region": "all_regions", "industry_id": "nothing", "new_to_top_100": "false"}, headers={'Authorization': 'Bearer '} ) print(response.json()) - lang: javascript label: JavaScript source: >- const params = new URLSearchParams({"page": "1", "limit": "20", "period": "7", "region": "all_regions", "industry_id": "nothing", "new_to_top_100": "false"}); const response = await fetch(`https://api.keyapi.ai/v1/tiktok/trending/hashtags?${params}`, { method: 'GET', headers: { 'Authorization': 'Bearer ' } }); const data = await response.json(); console.log(data); components: securitySchemes: JWT Bearer: type: http scheme: bearer bearerFormat: JWT description: |- 接口鉴权凭证。请在请求 Header 中传入 `Authorization: Bearer `。 可在 [Dashboard](https://keyapi.ai/app/dashboard) 获取你的 API Key。 ````