tiktok/
search-photos

按关键词只搜索 TikTok 图文轮播帖(不含视频),返回每一张轮播图片,以及文案、话题标签、创作者和播放、点赞、评论、分享数。

TikTok Photo Search API

关键词搜索
只返回图文帖子
轮播里的每张图
每条结果 0.6 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

TikTok Photo Search

TikTok 的图文帖(Photo Mode)是一组可以左右滑动的静态图片,发布时带文案、话题标签和配乐,播放、点赞、评论、分享这些数据和视频一样会累计。只看这类帖子,就能知道某个主题下哪些图文形式有效,比如穿搭九宫格、菜谱步骤、清单盘点和好物合集。

TikTok Photo Search API 主要特性

  • 只返回图文帖每条结果都是图文轮播帖,视频不在其中,关键词搜索的结果不会被视频冲淡。
  • 每张轮播图及其尺寸media 按翻页顺序列出帖子的每张图片,包含类型 type、链接 url、宽 width 和高 height。
  • 互动数据和帖子信息metrics 给出点赞、评论、分享、播放和观看数,每条帖子还带有 text 里的文案、话题标签、@ 提及、配乐和创作者的资料字段。

TikTok Photo Search API 参数

参数必填描述
query必填用于查找图文帖子的关键词。
results_limit可选返回的图文帖子数量,取值 1 到 500,默认 20。

如何使用 TikTok Photo Search API

用关键词搜索,分页读取匹配的图文帖子。

  1. 向 /v1/tiktok/search-photos 发送 {"query": "outfit ideas", "results_limit": 20}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
  3. 从 results.items 读取图文帖子;has_more 为 true 时,带上 results.next_cursor 继续读取。
curl -X POST "https://api.socq.ai/v1/tiktok/search-photos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"outfit ideas","results_limit":20}'

# media 按轮播顺序列出每条帖子的全部图片。

TikTok Photo Search API 最佳使用场景

  • 轮播图文形式对比: 对同一个关键词下的轮播帖,把 media 里的图片张数和点赞、评论、分享、观看数放在一起比较,看多少张的帖子反响最好。
  • 文案和话题标签研究: 读取某个关键词下表现最好的图文帖的 text 和 hashtags,看高表现内容的文案怎么写、标签怎么选。
  • 视觉趋势参考板: 收集某个关键词(如 outfit ideas)下热门帖子的轮播图片,为穿搭、美食、旅行内容整理参考图板。

TikTok Photo Search API 使用建议

  • 排序时用(点赞 + 评论 + 分享)除以 views_count,而不是只看点赞数,这样小账号的优质帖子不会被大账号压住;views_count 为空或为 0 的帖子先跳过。
  • 同一个主题的不同说法分别作为独立查询,比如 outfit ideas 和 ootd,合并结果时按 id 去重,因为一条图文帖可能被多个关键词命中。
  • 需要保存图片文件时,任务完成后尽快下载,TikTok 提供的是带签名的图片链接,会过期失效。
  • 统计配乐时按 audio.id 归类,不要按 audio.title,因为很多图文帖用的是创作者自己的声音,标题往往只是一个通用的“原声”标签。

除了 TikTok Photo Search API,需要其他类型的 TikTok 公开数据时,可以使用以下 API。

  • TikTok Profiles API — 按 username 获取公开主页身份、简介、账号标记和受众计数。
  • TikTok Hashtags API — 按指定标签采集公开视频、创作者、媒体、声音和互动指标。
  • TikTok Comments API — 采集公开顶级评论、作者、互动、提及和创作者互动标记。
  • TikTok Search API — 按关键词搜索公开视频,并支持排序和发布时间筛选。
  • TikTok Live Room Info API — 使用配对的直播间 ID 和主播 ID 查询一个已知直播间,返回状态、主播信息、封面和受众计数。
  • TikTok Comment Keywords API — 提取视频评论里出现最多的关键词,并附上对应的评论。

探索其他平台

还可以将 TikTok 数据与其他已支持社交平台的公开数据结合使用。

TikTok Photo Search API — 常见问题

TikTok Photo Search API 是一个用于按关键词搜索 TikTok 图文轮播帖的 API。它返回每条帖子的全部图片,以及文案、创作者、话题标签和播放、点赞、评论、分享数。

这个接口只返回图文轮播帖,结果里不含视频。

实际使用中是一回事。TikTok 官方叫图文帖(Photo Mode),创作者和运营习惯叫 Slideshow 或轮播;这里每条结果就是这样一条帖子,它的图片都在 media 里。

全部都会返回。media 按翻页顺序列出所有图片,每张都带链接、宽和高。

不能。结果里有点赞、评论、分享、播放和观看数,没有收藏数。

Top Search 对关键词返回视频和图文轮播混合的结果,Photo Search 只保留轮播帖,所以每条结果的图片都在 media 里。

results_limit 取值 1 到 500,默认 20。每返回一条图文帖扣 0.6 积分,没有匹配图文帖的搜索不扣费。