TikTok API

TikTok 热门话题标签 API

按国家和行业给 TikTok 热门话题标签排名,附每个话题标签的每日热度曲线、帖子数、视频播放量和头部创作者。可按 15 个行业类别排名,省略 industry 则返回全行业榜单。TikTok 只向匿名调用方公开每个榜单的前 3 个话题标签,所以 limit 为 1-3 时价格较低;limit 大于 3 时会路由到更贵的、已认证的数据源,返回完整排名。覆盖 27 个市场:AE、AR、AU、BR、CA、CO、DE、EG、ES、FR、GB、ID、IL、IT、JP、KR、MX、MY、PH、SA、SG、TH、TR、TW、US、VN、ZA。

POST/v1/run/tiktok.trending_hashtags
可用率
100.00%
30d · 202 次调用
请求数
202
30d · 按周,近 12 周
响应时间
0.9s
中位数 · 30d

调用方式

发出你的第一个请求

import os, requests

res = requests.post(
    "https://api.getanyapi.com/v1/run/tiktok.trending_hashtags",
    headers={"Authorization": f"Bearer {os.environ['ANYAPI_KEY']}"},
    json={},
)
print(res.json())
打开于
获取免费密钥
示例响应
{
  "data": {
    "items": [
      {
        "hashtag": "a1b2c3d4",
        "hashtagId": "a1b2c3d4",
        "industryIds": [
          1024
        ],
        "popularity": [
          {
            "atUtc": 12.5,
            "value": 19.99
          }
        ],
        "posts": 248,
        "rank": 1,
        "topCreators": [
          {
            "countryCode": "US",
            "followers": 12500,
            "handle": "alex_rivera",
            "image": "https://example.com/image.jpg",
            "nickname": "Example title",
            "rank": 1,
            "userId": "a1b2c3d4"
          }
        ],
        "views": 12500
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface TiktokTrendingHashtagsResponse {
  data: {
    items: {
      hashtag: string;
      hashtagId: string;
      industryIds?: number[];
      popularity?: {
        atUtc: number;
        value: number;
      }[];
      posts?: number;
      rank: number;
      topCreators?: {
        countryCode?: string;
        followers?: number;
        handle?: string;
        image?: string;
        nickname?: string;
        rank?: number;
        userId?: string;
      }[];
      views?: number;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

完整的参数与响应参考:这个接口的每个字段、类型和示例。

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/tiktok.trending_hashtags
curl -X POST https://api.getanyapi.com/v1/run/tiktok.trending_hashtags \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":3,"period":7,"region":"US"}'
字段类型示例值
请求体
industryenum将排名限定在一个行业。省略则返回全行业榜单。
limitinteger3最多返回的上榜话题标签数,取值 1 到 100(默认 3)。TikTok 只向匿名调用方公开每个榜单的前 3 个话题标签,所以 1 到 3 由最便宜的数据源处理;更高的 limit 会路由到读取完整排名的更贵的数据源。
periodenum7排名和热度曲线覆盖的回溯天数(默认 7)。
regionenum"US"要读取话题标签排名的市场的两字母国家代码(默认 US)。每个市场单独排名,所以 US 和 DE 返回不同的榜单。
requireFieldsarray可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `industryIds`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某个话题标签确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。
响应
dataobjectThe ranked hashtags for the requested market, or null when unavailable.
data.itemsobject[]Hashtags in the market's own ranking order, best first. Populated whenever the provider has data for the entity.
data.items[].hashtagstringHashtag name without the leading #. Populated whenever the provider has data for the entity.
data.items[].hashtagIdstringStable TikTok hashtag identifier. Populated whenever the provider has data for the entity.
data.items[].industryIds可设为必填integer[]TikTok industry identifiers the hashtag is classified under, matching the ids behind the `industry` input. Empty when TikTok classifies the hashtag under none.
data.items[].popularityobject[]Daily popularity curve across the requested period, oldest first. Values are normalized 0-100 within this hashtag's own window, where 100 is its peak day, so they compare days of one hashtag rather than two hashtags. Populated whenever the provider has data for the entity.
data.items[].popularity[].atUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
data.items[].popularity[].valuenumberNormalized popularity for that day, 0 through 100.
data.items[].postsintegerNumber of videos published with the hashtag during the period. Populated whenever the provider has data for the entity.
data.items[].rankintegerOne-based position in this market's ranking for the requested period. Populated whenever the provider has data for the entity.
data.items[].topCreatorsobject[]Creators TikTok surfaces as leading the hashtag, in its own order.
data.items[].topCreators[].countryCodestringTwo-letter country code TikTok reports for the creator.
data.items[].topCreators[].followersintegerCreator's follower count.
data.items[].topCreators[].handlestringCreator's TikTok username without the leading @.
data.items[].topCreators[].imagestringCreator's avatar image URL.
data.items[].topCreators[].nicknamestringCreator's display name.
data.items[].topCreators[].rankintegerOne-based position among the hashtag's top creators.
data.items[].topCreators[].userIdstringCreator's stable TikTok user id.
data.items[].viewsintegerTotal video views the hashtag drew during the period. Populated whenever the provider has data for the entity.
foundbooleanWhether a hashtag ranking was resolved for the requested market.
reason"not_found"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
价格
每次请求价格USDUS$0.0012
价格(/千次请求)USDUS$1.20

常见问题

关于 TikTok 热门话题标签 API

AnyAPI 的 TikTok 热门话题标签 API 只需一次 POST 请求 /v1/run/tiktok.trending_hashtags,就以统一格式的 JSON 返回 TikTok 数据。按国家和行业给 TikTok 热门话题标签排名,附每个话题标签的每日热度曲线、帖子数、视频播放量和头部创作者。可按 15 个行业类别排名,省略 industry 则返回全行业榜单。TikTok 只向匿名调用方公开每个榜单的前 3 个话题标签,所以 limit 为 1-3 时价格较低;limit 大于 3 时会路由到更贵的、已认证的数据源,返回完整排名。覆盖 27 个市场:AE、AR、AU、BR、CA、CO、DE、EG、ES、FR、GB、ID、IL、IT、JP、KR、MX、MY、PH、SA、SG、TH、TR、TW、US、VN、ZA。AnyAPI 会在 2 个数据源之间路由每个请求,某个数据源失败时自动切换。费用:每千次请求 US$1.20 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 TikTok 热门话题标签 API 调用中有 100.0% 成功,响应时间中位数为 0.9 秒,共测量 202 次调用。

费用:每千次请求 US$1.20 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。

按国家和行业给 TikTok 热门话题标签排名,附每个话题标签的每日热度曲线、帖子数、视频播放量和头部创作者。可按 15 个行业类别排名,省略 industry 则返回全行业榜单。TikTok 只向匿名调用方公开每个榜单的前 3 个话题标签,所以 limit 为 1-3 时价格较低;limit 大于 3 时会路由到更贵的、已认证的数据源,返回完整排名。覆盖 27 个市场:AE、AR、AU、BR、CA、CO、DE、EG、ES、FR、GB、ID、IL、IT、JP、KR、MX、MY、PH、SA、SG、TH、TR、TW、US、VN、ZA。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

过去 30 天,通过 AnyAPI 发起的 TikTok 热门话题标签 API 调用中有 100.0% 成功,响应时间中位数为 0.9 秒,共测量 202 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。