TikTok API

TikTok 搜索图文 API

按关键词搜索 TikTok 图文(幻灯片)帖子,返回每条帖子中的全部图片,以及播放量、点赞数和评论数。tiktok.search_keyword 只返回视频,会丢掉这类帖子。

POST/v1/run/tiktok.search_photos
可用率
100.00%
30d · 27 次调用
请求数
33
30d
响应时间
1.4s
中位数 · 30d

价格

一个价格,以美元计

试一试

发出你的第一个请求

打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "data": {
    "nextCursor": "example",
    "posts": [
      {
        "author": "Alex Rivera",
        "authorFollowers": 12500,
        "authorName": "Alex Rivera",
        "authorSecUid": "Alex Rivera",
        "authorVerified": true,
        "caption": "A short example description of this item.",
        "comments": 12500,
        "createdUtc": 12.5,
        "hashtags": [
          "a1b2c3d4"
        ],
        "id": "a1b2c3d4",
        "images": [
          {
            "height": 42,
            "image": "https://example.com/image.jpg",
            "width": 1024
          }
        ],
        "likes": 12500,
        "saves": 42,
        "shares": 13,
        "soundAuthor": "Alex Rivera",
        "soundClipId": "a1b2c3d4",
        "soundTitle": "Example title",
        "title": "Example title",
        "views": 12500
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface TiktokSearchPhotosResponse {
  data: {
    nextCursor: string | null;
    posts: {
      author: string;
      authorFollowers?: number;
      authorName?: string;
      authorSecUid?: string;
      authorVerified?: boolean;
      caption: string;
      comments: number;
      createdUtc: number;
      hashtags?: string[];
      id: string;
      images?: {
        height?: number;
        image: string;
        width?: number;
      }[];
      likes: number;
      saves?: number;
      shares: number;
      soundAuthor?: string;
      soundClipId?: string;
      soundTitle?: string;
      title?: string;
      views: number;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

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

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/tiktok.search_photos
curl -X POST https://api.getanyapi.com/v1/run/tiktok.search_photos \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"latte art"}'
字段类型示例值
请求体
querystring"latte art"搜索关键词。
cursorstring上一次响应的 nextCursor 返回的分页游标。
limitinteger单页最多返回的条目数。
响应
dataobject
data.nextCursorstringOpaque cursor for the next page, or null when there are no more. Pass it back as cursor to continue.
data.postsobject[]Photo-mode posts matching the keyword.
data.posts[].authorstringHandle of the account that posted the video, without the leading @. Populated whenever the provider has data for the entity.
data.posts[].authorFollowersintegerThe author's follower count at the time of the request. TikTok rounds this for large accounts.
data.posts[].authorNamestringThe author's display name, which is not the handle and can contain any characters.
data.posts[].authorSecUidstringThe author's TikTok sec_uid. Pass it straight to tiktok.profile_reposts or tiktok.profile_playlists to pivot to that creator without a tiktok.profile lookup.
data.posts[].authorVerifiedboolean
data.posts[].captionstringPopulated whenever the provider has data for the entity.
data.posts[].commentsinteger
data.posts[].createdUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.
data.posts[].hashtagsstring[]Hashtags carried in the caption, without the leading #. Empty when the post uses none; @-mentions are excluded.
data.posts[].idstringTikTok video id. Pass it to tiktok.video as id for the full record. Populated whenever the provider has data for the entity.
data.posts[].imagesobject[]The slideshow's images in order.
data.posts[].images[].heightinteger
data.posts[].images[].imagestringImage URL. A signed, short-lived TikTok CDN URL - the query params are load-bearing, so keep the URL intact. Populated whenever the provider has data for the entity.
data.posts[].images[].widthinteger
data.posts[].likesinteger
data.posts[].savesinteger
data.posts[].sharesinteger
data.posts[].soundAuthorstringCredited author of the sound.
data.posts[].soundClipIdstringId of the sound the post uses. Pass it to tiktok.song or tiktok.song_videos as clipId.
data.posts[].soundTitlestringName of the sound. "original sound" means the creator's own audio rather than a licensed track.
data.posts[].titlestringThe slideshow's own title, which TikTok stores separately from the caption. Absent when the creator set none.
data.posts[].viewsinteger
foundboolean
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.search_photos,就以统一格式的 JSON 返回 TikTok 数据。按关键词搜索 TikTok 图文(幻灯片)帖子,返回每条帖子中的全部图片,以及播放量、点赞数和评论数。tiktok.search_keyword 只返回视频,会丢掉这类帖子。无论哪个数据源提供服务,AnyAPI 都返回同一套统一的 schema。费用:每千次请求 US$1.20 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 TikTok 搜索图文 API 调用中有 100.0% 成功,响应时间中位数为 1.4 秒,共测量 27 次调用。

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

按关键词搜索 TikTok 图文(幻灯片)帖子,返回每条帖子中的全部图片,以及播放量、点赞数和评论数。tiktok.search_keyword 只返回视频,会丢掉这类帖子。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

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