TikTok API

TikTok 话题标签视频 API

列出某个话题标签下最近的 TikTok 视频(创作者、文案、播放量、点赞数、分享数)。

POST/v1/run/tiktok.hashtag_videos
可用率
99.40%
30d · 168 次调用
请求数
168
30d · 按周,近 12 周
响应时间
17.9s
中位数 · 30d

试一试

发出你的第一个请求

requireFieldsarray
可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `playCount`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某个视频确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。只返回某个字段的四舍五入值或缩写值的数据源,不算返回了该字段。
打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "data": {
    "items": [
      {
        "authorHandle": "alex_rivera",
        "authorImage": "https://example.com/image.jpg",
        "authorName": "Alex Rivera",
        "authorUserId": "Alex Rivera",
        "authorVerified": true,
        "collectCount": 12500,
        "commentCount": 12500,
        "createdUtc": 12.5,
        "durationSeconds": 12.5,
        "id": "a1b2c3d4",
        "image": "https://example.com/image.jpg",
        "likeCount": 12500,
        "playCount": 12500,
        "shareCount": 13,
        "text": "A short example description of this item.",
        "url": "https://example.com/page",
        "videoUrl": "https://example.com/page"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface TiktokHashtagVideosResponse {
  data: {
    items: {
      authorHandle?: string;
      authorImage?: string;
      authorName?: string;
      authorUserId?: string;
      authorVerified?: boolean;
      collectCount?: number;
      commentCount?: number;
      createdUtc: number;
      durationSeconds?: number;
      id: string;
      image?: string;
      likeCount?: number;
      playCount?: number;
      shareCount?: number;
      text?: string;
      url: string;
      videoUrl?: string;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

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

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/tiktok.hashtag_videos
curl -X POST https://api.getanyapi.com/v1/run/tiktok.hashtag_videos \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtag":"cooking","limit":3}'
字段类型示例值
请求体
hashtagstring"cooking"要获取视频的 TikTok 话题标签,不带 # 前缀(例如 booktok)。
limitinteger3最多返回的结果数(1-20,默认 20)。
requireFieldsarray可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `playCount`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某个视频确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。只返回某个字段的四舍五入值或缩写值的数据源,不算返回了该字段。
响应
dataobject
data.itemsobject[]Recent TikTok video records for the hashtag. Populated whenever the provider has data for the entity.
data.items[].authorHandlestringUsername of the video's creator, without the @ prefix. Empty when the upstream omits it.
data.items[].authorImagestringAuthor's avatar image URL. Signed and short-lived, so the query string is load-bearing and kept intact.
data.items[].authorNamestringAuthor's display name.
data.items[].authorUserIdstringAuthor's numeric TikTok user id.
data.items[].authorVerifiedbooleanWhether the author's account carries a TikTok verification badge.
data.items[].collectCountintegerNumber of times the video was saved.
data.items[].commentCount可设为必填integerNumber of comments on the video. Some sources round large counts (27.7M instead of 27,712,408); name the field in requireFields to be served only by a source that returns the exact count.
data.items[].createdUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
data.items[].durationSecondsnumberVideo duration in seconds.
data.items[].idstringThe video's numeric TikTok ID, as a string. Populated whenever the provider has data for the entity.
data.items[].imagestringURL of the video's cover/thumbnail image, with tracking query params stripped. Empty when the upstream omits it.
data.items[].likeCount可设为必填integerNumber of likes on the video. Some sources round large counts (27.7M instead of 27,712,408); name the field in requireFields to be served only by a source that returns the exact count.
data.items[].playCount可设为必填integerNumber of views/plays of the video. Some sources round large counts (27.7M instead of 27,712,408); name the field in requireFields to be served only by a source that returns the exact count.
data.items[].shareCount可设为必填integerNumber of shares of the video. Some sources round large counts (27.7M instead of 27,712,408); name the field in requireFields to be served only by a source that returns the exact count.
data.items[].textstringThe video caption text. Empty for videos with no caption.
data.items[].urlstringCanonical tiktok.com URL of the video, with tracking query params stripped. Populated whenever the provider has data for the entity.
data.items[].videoUrlstringPlayable video URL. Signed and short-lived, so the query string is load-bearing and kept intact.
foundbooleanWhether any videos were returned for the hashtag.
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.0008
价格(/千次请求)USDUS$0.80

常见问题

关于 TikTok 话题标签视频 API

AnyAPI 的 TikTok 话题标签视频 API 只需一次 POST 请求 /v1/run/tiktok.hashtag_videos,就以统一格式的 JSON 返回 TikTok 数据。列出某个话题标签下最近的 TikTok 视频(创作者、文案、播放量、点赞数、分享数)。AnyAPI 会在 3 个数据源之间路由每个请求,某个数据源失败时自动切换。费用:每千次请求 US$0.80 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 TikTok 话题标签视频 API 调用中有 99.4% 成功,响应时间中位数为 17.9 秒,共测量 168 次调用。

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

列出某个话题标签下最近的 TikTok 视频(创作者、文案、播放量、点赞数、分享数)。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

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