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
用关键词搜索,分页读取匹配的图文帖子。
- 向 /v1/tiktok/search-photos 发送 {"query": "outfit ideas", "results_limit": 20}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 从 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,因为很多图文帖用的是创作者自己的声音,标题往往只是一个通用的“原声”标签。
相关 API
除了 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 Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API