Threads API 数据接口
帖子、账号。
Threads API(数据接口)可以搜帖子,读帖子详情、账号资料和账号发布的帖子,不用登录 Threads 账号,也不用提供 Cookie。每次调用 2 积分(约 $0.004–$0.0067),失败不扣。Threads 的内容不带作者粉丝数,这个字段返回 null。可以直接发 HTTP 请求,也可以通过 MCP 接到 AI 客户端里用。最近实测:2026-10-17。
6 个里 4 个动作可用
2 积分起每次调用
同一种格式和其他调用一样
最近实测:最近更新:
POST
/v1/search200 OK2 积分platform: "threads" · query: "nasa"likes 43,152comments 3,630shares 1,775collects
nullviews nullreposts 3,369这里始终是 null:
titleauthor.followersmetrics.collectsmetrics.viewspage下一页cursor
billing本次调用2 积分
示例数据录制的 19 条里的 1 条
4 个动作。
同一种返回格式。
点开任意一行,看请求怎么写;完整的参数和返回字段在它自己的页面。
动作每次调用积分
搜索按关键词找帖子:正文、作者、点赞数、评论数和发布时间。/v1/search2 积分
cURL
curl https://api.socialtoai.com/v1/search \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "platform": "threads", "query": "nasa" }'POST /v1/searchKey 放在 Authorization 请求头里详情用编号或链接取一条帖子:正文、作者、点赞数、评论数、播放或阅读数和发布时间。/v1/detail2 积分
cURL
curl https://api.socialtoai.com/v1/detail \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "platform": "threads", "id": "Dc3vb5DES3i" }'POST /v1/detailKey 放在 Authorization 请求头里账号资料一个账号:名称、简介和粉丝数。/v1/user_profile2 积分
cURL
curl https://api.socialtoai.com/v1/user_profile \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "platform": "threads", "username": "nasa" }'POST /v1/user_profileKey 放在 Authorization 请求头里账号作品一个账号最近发布的帖子。/v1/user_posts2 积分
cURL
curl https://api.socialtoai.com/v1/user_posts \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "platform": "threads", "username": "nasa" }'POST /v1/user_postsKey 放在 Authorization 请求头里Threads 不提供:热榜和评论。
也可以不管参数。
直接问。
通过 MCP 接一次 SocialToAI,之后该调哪些接口由 AI 决定,每一步花了多少积分你都看得到。
你问01
这周 Threads 上,家用咖啡和抹茶哪个更火?
AI 会调用
- search“home coffee”2 积分
- search“matcha”2 积分
合计4 积分
你问02
这个 Threads 账号有多大?最近发了什么?
AI 会调用
- user_profile你说的那个账号2 积分
- user_posts最近一页2 积分
合计4 积分
你问03
查一下这个 Threads 账号,告诉我它是谁。
AI 会调用
- user_profile你说的那个账号2 积分
合计2 积分
每个平台,同一种结构。
学一次就够。
Threads 的帖子和小红书的笔记,返回的字段名一模一样。平台给不了的字段,返回 null。
Threads详情 · 2 积分
{ "platform": "threads", "id": "…", "ref": "…", "approx": [], "type": "content", "url": "https://example.com/…", "format": "text", "title": null, "text": "…", "published_at": "2026-09-04T15:46:28.000Z", "author": { "id": "…", "username": "…", "name": "…", "verified": true, "followers": null }, "metrics": { "likes": 1466, "comments": 43, "shares": 9, "collects": null, "views": 37509, "reposts": 111 }, "images": [], "hashtags": ["…"], "is_pinned": false}Threads 给不了,返回 null:
titleauthor.followersmetrics.collects小红书详情 · 12 积分
{ "platform": "xiaohongshu", "id": "…", "ref": "…", "approx": [], "type": "content", "url": "https://example.com/…", "format": "image", "title": "…", "text": "…", "published_at": "2026-10-09T01:00:34.000Z", "author": { "id": "…", "username": "…", "name": "…", "verified": null, "followers": null }, "metrics": { "likes": 927, "comments": 122, "shares": 256, "collects": 59, "views": null, "reposts": null }, "images": ["https://example.com/…", "https://example.com/…"], "hashtags": ["…", "…"], "is_pinned": false}小红书给不了,返回 null:
author.verifiedauthor.followersmetrics.viewsmetrics.reposts示例数据字段恒在,变的只是值。
4 个工具能读 Threads。
全部工具Threads 有官方 API 吗?
Threads API 主要服务于授权该应用的用户。应用获批关键词搜索权限后,可按关键词搜索公开帖子(获批前只能搜到用户本人的帖子);查询公开主页资料,除 Meta 官方账号外也需获批。
来源:Threads 官方开发者文档,核对于 2026-10-17。