社交内容 · 数据 API

Threads API

帖子、回复链、粉丝与发现页——Meta 新社交的舆论与达人挖掘。调 POST /api/v1/social 就行,返回结构化 JSON,$0.56 / 千次/次、失败不计费。

免费开始看文档

个能力

$0.56 / 千次

每次调用

秒级

响应

1 个

API Key 通 87 平台

Threads 能力清单

action	必填参数	可选参数	单次条数	模式	单价 / 次	返回字段
search	keyword	—	默认 15 · 最多 50	同步	$0.56 / 千次	id · url · text · author_name · author_username · author_id · like_count · comment_count · posted_at · platform
profile	username	—	—	同步	$0.56 / 千次	user_id · username · display_name · bio · follower_count · is_verified · is_private · url · avatar_url · platform
user_posts	username	—	默认 10 · 最多 50	同步	$0.56 / 千次	id · code · url · text · author_username · author_name · author_is_verified · like_count · comment_count · repost_count · quote_count · share_count · view_count · posted_at · platform
post_detail	url	—	—	同步	$0.56 / 千次	id · code · url · text · author_username · author_name · author_is_verified · like_count · comment_count · repost_count · quote_count · share_count · view_count · posted_at · is_paid_partnership · platform
comments	url	—	—	同步	$0.56 / 千次	id · url · text · author_username · author_name · author_is_verified · like_count · comment_count · reply_to · posted_at · platform
discover_profiles	keyword	since, until	默认 10 · 最多 50	异步	$0.56 / 千次	username · display_name · bio · follower_count · is_verified · url · avatar_url · platform
followers	username	channel	—	同步	$0.56 / 千次	id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform

Threads 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。请求都发到 POST /api/v1/social，只需切换 action。

怎么调用 Threads 关键词搜索 API？

search

使用 platform="threads"、action="search" 调用“关键词搜索”能力；返回列表，默认 15 条、单次最多 50 条，主要包含 id、url、text、author_name、author_username、author_id 等 10 个字段。

keyword必填: 检索关键词。

怎么调用 Threads 主页或对象详情 API？

profile

使用 platform="threads"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 user_id、username、display_name、bio、follower_count、is_verified 等 10 个字段。

username必填: 账号用户名（@handle），不带 @ 前缀。

Threads 特有返回字段与含义（1）

is_private: 账号是否私密。

怎么调用 Threads 用户内容 API？

user_posts

使用 platform="threads"、action="user_posts" 调用“用户内容”能力；返回列表，默认 10 条、单次最多 50 条，主要包含 id、code、url、text、author_username、author_name 等 15 个字段。

username必填: 账号用户名（@handle），不带 @ 前缀。

Threads 特有返回字段与含义（3）

code: 内容短码，用于拼 URL。
author_is_verified: 作者是否已认证。
quote_count: 引用转发数。

怎么调用 Threads 内容详情 API？

post_detail

使用 platform="threads"、action="post_detail" 调用“内容详情”能力；返回单个对象，主要包含 id、code、url、text、author_username、author_name 等 16 个字段。

url必填: 目标页面的完整链接，直接从该平台复制。

Threads 特有返回字段与含义（4）

code: 内容短码，用于拼 URL。
author_is_verified: 作者是否已认证。
quote_count: 引用转发数。
is_paid_partnership: 是否标注为付费合作内容。识别广告用。

怎么调用 Threads 评论 API？

comments

使用 platform="threads"、action="comments" 调用“评论”能力；返回列表，主要包含 id、url、text、author_username、author_name、author_is_verified 等 11 个字段。

url必填: 目标页面的完整链接，直接从该平台复制。

Threads 特有返回字段与含义（2）

author_is_verified: 作者是否已认证。
reply_to: 被回复的内容。

怎么调用 Threads 账号发现 API？

discover_profiles

使用 platform="threads"、action="discover_profiles" 调用“账号发现”能力；返回列表，默认 10 条、单次最多 50 条，主要包含 username、display_name、bio、follower_count、is_verified、url 等 8 个字段。

keyword必填: 检索关键词。
since可选: 起始时间，ISO 日期（YYYY-MM-DD）。只返回该时刻之后的内容。
until可选: 截止时间，ISO 日期（YYYY-MM-DD）。只返回该时刻之前的内容。

怎么调用 Threads 粉丝列表 API？

followers

使用 platform="threads"、action="followers" 调用“粉丝列表”能力；返回单个对象，主要包含 id、username、url、follower_count、following_count、post_count 等 10 个字段。

username必填: 账号用户名（@handle），不带 @ 前缀。
channel可选: 频道标识（用户名或频道 ID，随平台而异）。

Threads 特有返回字段与含义（2）

connection_count: 粉丝数。
precision: 数据精确度标记，Threads 对模糊值（如「10万+」）的标注。

一次 Threads search 调用的全过程:向 POST /api/v1/social 发送 platform="threads"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、text、author_name、author_username 等字段;单次最多 50 条,计费 $0.56 / 千次,失败与空结果不计费。

Threads 原始字段名

EveryInfra 统一字段名

左边是 Threads 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。右边这一列在 87 个平台上是同一套—— 换平台时只改请求里的 platform 一个字段，解析代码一行不用动。

只有 Threads 返回的字段

全站 87 个平台里，这 3 个字段只有 Threads 会返回——换别的平台拿不到这些数据。字段名与其余平台同样遵循 snake_case 命名，解析方式一致。

code
is_paid_partnership
reply_to

返回字段含义

字段名跨 87 个平台统一，同一个键在哪个平台都是同一个意思—— 这也是换平台只需改 platform 一个字段的原因。机器可读版:/api/v1/social/fields

id: 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url: 该记录在原平台上的可访问链接。
text: 正文内容，已去除 HTML 标签。长文可能被截断。
author_name: 作者昵称（显示名）。
author_username: 作者用户名（@handle），通常可用于拼 URL。
author_id: 作者在原平台的唯一 ID。
like_count: 点赞数。null 表示该平台或该接口不公开此数据，不等于 0。
comment_count: 评论数。null 表示不公开，不等于 0。
posted_at: 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
platform: 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
user_id: 用户在原平台的唯一 ID。
username: 用户名（@handle）。
display_name: 显示名，可能与 username 不同。
bio: 个人简介，账号自己填写的文本。可能含换行和 emoji。
follower_count: 粉丝数。null 表示不公开，不等于 0。
is_verified: 是否为平台认证账号（蓝V等）。null 表示无法判定。
avatar_url: 头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。
repost_count: 转发数（区别于引用转发）。null 表示不公开。
share_count: 分享/转发数。null 表示不公开，不等于 0。
view_count: 浏览/播放数。null 表示不公开，不等于 0。
following_count: 关注数。null 表示不公开，不等于 0。
post_count: 发布内容总数。null 表示不公开，不等于 0。

另有 Threads 特有字段 is_private · code · author_is_verified · quote_count · is_paid_partnership · reply_to · connection_count · precision，保留该平台自身的语义。

30 秒调用示例

threads_search.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"threads","action":"search","params":{"keyword":"咖啡"}}'

返回长这样

response.json

{
  "id": "threads_…",
  "search": [
    {
      "id": "…",
      "url": "https://…",
      "text": "…",
      "author_name": "…",
      "author_username": "…",
      "author_id": "…",
      "like_count": 128,
      "comment_count": 128,
      "posted_at": "2026-08-01T09:30:00Z",
      "platform": "threads"
    }
  ],
  "count": 15,
  "billing": { "charged": true, "credits": 40, "cny": 0.003742 }
}

常见用例

关键词监控

按关键词轮询 Threads 的新内容，配合 Gemini 文本 API 做情绪分类与异常波动告警。

评论洞察 / 截流

抓 Threads 的评论区做用户真实反馈分析，或识别高意向留言做互动。

账号与主体画像

按 Threads 的主页数据建达人/商家档案，做投放筛选或竞品盯防。

内容追踪

持续拉取指定账号在 Threads 的历史与新增内容，做选题与节奏分析。

Threads API 常见问题

Threads API 怎么调用?

调 POST /api/v1/social,请求体传 platform="threads"、action 和 params。以 search 为例,必填 keyword,没有可选参数。Threads 共 7 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 87 个平台。

Threads API 怎么收费?

$0.56 / 千次/次,Threads 全部 7 个能力同价。$1 免费额度约等于 1,798 次 Threads 调用。一次调用一次计费,不按条数或页数加价;参数错误、鉴权失败和空结果都不计费。

Threads API 一次能返回多少条数据?

最多的是 search,单次上限 50 条(默认 15 条)。另外 4 个能力返回单个对象,没有条数概念。传 limit 控制,一次调用就返回这么多,不需要翻页也不多收钱。

Threads API 返回哪些字段?

search 返回 id、url、text、author_name、author_username、author_id 等 10 个字段。其中 3 个字段只有 Threads 会返回(见上方「独有字段」)。字段名跨平台统一,换平台不用改解析代码。

Threads API 的异步能力怎么用?

discover_profiles 是异步能力:提交后立即返回 job_id,用 GET /api/v1/jobs/{job_id} 轮询取结果。只在提交时计费一次,轮询免费。

Threads怎么按关键词批量采集?

调 POST /api/v1/social,传 platform="threads"、action="search",必填参数 keyword。单次最多 50 条,一次调用一次计费、不按条数加价;单价 $0.56 / 千次,失败与空结果不计费。返回结构化 JSON,关键词搜索字段为 id、url、text、author_name、author_username。

Threads账号资料怎么批量抓取?

调 POST /api/v1/social,传 platform="threads"、action="profile",必填参数 username。返回单个对象,没有条数上限;单价 $0.56 / 千次,失败与空结果不计费。返回结构化 JSON,账号资料字段为 user_id、username、display_name、bio、follower_count。

怎么批量抓取Threads某个账号的全部内容?

调 POST /api/v1/social,传 platform="threads"、action="user_posts",必填参数 username。单次最多 50 条,一次调用一次计费、不按条数加价;单价 $0.56 / 千次,失败与空结果不计费。返回结构化 JSON,账号内容字段为 id、code、url、text、author_username。

Threads评论怎么批量采集?

调 POST /api/v1/social,传 platform="threads"、action="comments",必填参数 url。返回单个对象,没有条数上限;单价 $0.56 / 千次,失败与空结果不计费。返回结构化 JSON,评论数据字段为 id、url、text、author_username、author_name。

可以先免费试用 Threads API 吗?

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用或 576 次 AI 调用),足够把 Threads 的 7 个能力都试一遍。无需信用卡。

Behance API B站 API Bluesky API Dailymotion API DeviantArt API Discord API 豆瓣 API 抖音 API 全部 87 平台 ↗

开始调用 Threads API

加微信领 $1 免费额度 —— ≈720 次数据调用或 576 次 AI 调用,足够把 Threads 的能力全试一遍。

免费开始