| 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 · external_url |
| 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 · media_type · hashtags · mentions |
| 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 · media_url · hashtags |
| 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 · emails · phones · external_links |
| followers | username | channel | — | 同步 | $0.56 / 千次 | id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform |
下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。
下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。
search使用 platform="threads"、action="search" 调用“关键词搜索”能力；返回列表，默认 15 条、单次最多 50 条，主要包含 id、url、text、author_name、author_username、author_id 等 10 个字段。
keyword必填官方介绍用检索词发现公开帖子，并区分回复、转发、引用和应用外分享。该文定义 Threads 产品对象，不代表本接口支持官方所有筛选、写入或分析能力。官方来源：Meta 官方：Threads 关键词发现与互动指标来源核查：
profile使用 platform="threads"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 user_id、username、display_name、bio、follower_count、is_verified 等 11 个字段。
username必填官方定义 username、展示名称、bio 和 follower_count；公开资料发现需要相应权限，标准访问仅限部分官方账号，正文还列出公开账号与粉丝门槛等限制。本页引用用于术语解释，不宣称 EveryInfra 持有该权限或与官方端点范围相同。官方来源：Meta 官方：Threads 资料和粉丝计数的含义及访问限制来源核查：
user_posts使用 platform="threads"、action="user_posts" 调用“用户内容”能力；返回列表，默认 10 条、单次最多 50 条，主要包含 id、code、url、text、author_username、author_name 等 18 个字段。
username必填官方区分用户资料与用户帖子端点，公开 profile_posts 以精确 username 定位，列出 id、shortcode、permalink 等不同字段。官方 access_token、分页和日期参数不能直接视作本接口支持项。官方来源：Meta 官方：按 Threads 用户名定位帖子来源核查：
post_detail使用 platform="threads"、action="post_detail" 调用“内容详情”能力；返回单个对象，主要包含 id、code、url、text、author_username、author_name 等 18 个字段。
url必填官方把 reposts、quotes 和 shares 分列，并将 shares 解释为应用外分享。只用于理解原帖互动口径，不证明本接口每次都有所有指标或可执行发布动作。官方来源：Meta 官方：Threads 的转发、引用和应用外分享来源核查：
comments使用 platform="threads"、action="comments" 调用“评论”能力；返回列表，主要包含 id、url、text、author_username、author_name、author_is_verified 等 11 个字段。
url必填官方区分仅顶层 replies 与不限深度 conversation，并将 replied_to 定义为直接父内容 ID。本接口 reply_to 当前是被回复用户名，不等价于官方 replied_to，也不保证完整回复树；官方文档另有可见性和版权导致字段缺失的限制。官方来源：Meta 官方：顶层回复与完整 Conversation 不是同一范围来源核查：
官方回复管理文档聚焦用户自己的 Threads，并要求适当 access token 与读取权限；引用不是对任意第三方帖子访问权的保证，也不是本产品已取得平台授权的证明。官方来源：Meta 官方：Threads 回复读取需要权限来源核查：
discover_profiles使用 platform="threads"、action="discover_profiles" 调用“账号发现”能力；返回列表，默认 10 条、单次最多 50 条，主要包含 username、display_name、bio、follower_count、is_verified、url 等 11 个字段。
Meta 的 profile_lookup 是受权限、访问级别和账号条件约束的精确 username 查询；EveryInfra discover_profiles 使用 keyword 发现候选账号，两者不是同一能力。该来源仅用于解释这一边界，不能证明关键词发现的覆盖范围、排序或平台授权。官方来源：Meta 官方：公开资料发现不是任意关键词精确查人来源核查：
followers使用 platform="threads"、action="followers" 调用“粉丝数量”能力；返回单个对象，主要包含 id、username、url、follower_count、following_count、post_count 等 10 个字段。
username必填官方定义 username、展示名称、bio 和 follower_count；公开资料发现需要相应权限，标准访问仅限部分官方账号，正文还列出公开账号与粉丝门槛等限制。本页引用用于术语解释，不宣称 EveryInfra 持有该权限或与官方端点范围相同。官方来源：Meta 官方：Threads 资料和粉丝计数的含义及访问限制来源核查：
channel可选Threads 原始字段名
EveryInfra 统一字段名
左边是 Threads 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。
全站 89 个平台的当前目录中，这 5 个字段名只在 Threads 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。
通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields
当前目录另列出 external_url · media_type · hashtags · mentions · media_url · emails · phones · external_links，这些字段尚无逐项释义；请先核对 Threads 对应接口的用例与实际响应，不按字段名猜测类型或含义。
这里检索公开内容；粉丝数量接口不等于可导出粉丝名单。
以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。
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":"indie development"}}'
仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。
{ "id": null, "url": null, "text": null, "author_name": null, "author_username": null, "author_id": null, "like_count": null, "comment_count": null, "posted_at": null, "platform": null }
以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。
search 以 keyword 查找可获取的 Threads 帖子，用来发现围绕产品、品牌或主题的公开讨论样本。
查看 search 的 keyword 参数 →profile 用于验证单个 Threads 账号的公开资料，不把显示名当作唯一标识符。
查看 profile 的 username 参数 →user_posts 按作者 username 读取帖子列表，不返回账号资料行，也不把不同互动指标合并为一种转发量。
查看 user_posts 的 username 参数 →post_detail 以完整帖子 url 返回单个原帖对象，适合复核一条讨论的文本、作者及可得的互动快照。
查看 post_detail 的 url 参数 →comments 按帖子 url 返回可获取的回复行；当前输出没有稳定的父内容 ID 和层级结构，不能据此承诺完整会话树。
查看 comments 的 url 参数 →discover_profiles 用 keyword 提交账号发现任务，返回与关键词相关的账号资料候选，和 profile 的单账号定位是不同入口。
查看 discover_profiles 的 keyword 参数 →followers 返回一个账号计数对象，适合检查可得的粉丝规模，不逐人导出关注关系。
查看 followers 的 username 参数 →调用 POST /api/v1/social，请求体传 platform="threads"、action 和 params。以 search 为例，必填 keyword，没有可选参数。这里检索公开内容；粉丝数量接口不等于可导出粉丝名单。 Threads 共 7 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。
$0.56 / 千次，Threads 全部 7 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 1,798 次 Threads 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。
Threads 有 4 个列表接口，包括 search、user_posts、comments、discover_profiles。其余 3 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。
当前目录为 search 列出 id、url、text、author_name、author_username、author_id 等 10 个字段名。按全站当前目录统计，5 个字段名只在 Threads 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。
discover_profiles 是异步能力：提交后立即返回 job_id，用 GET /api/v1/jobs/{job_id} 轮询取结果。只在提交时计费一次，轮询免费。
search 以 keyword 查找可获取的 Threads 帖子，用来发现围绕产品、品牌或主题的公开讨论样本。 keyword 是用于检索内容的词，不是作者的 username；当前接口没有开放 sort、since 或 until 参数，不要直接将官方 API 的筛选参数传给此接口。默认请求 15 条、上限 50 条，不保证覆盖全站。 text、posted_at 描述帖子，author_username、author_id 描述作者；like_count 和 comment_count 分别是点赞与回复计数，comment_count 不包含可直接使用的回复正文。需要读取回复时另用 comments。
profile 用于验证单个 Threads 账号的公开资料，不把显示名当作唯一标识符。 username 必填，使用裸用户名或 @用户名；当前此入口只处理用户名，不应传整段个人主页 URL。user_id 是响应中的用户标识，display_name 是展示名称，不能拿显示名称替代请求 username。 bio、avatar_url、is_verified、follower_count 是可获得的资料字段。is_private 只表达返回中的隐私状态，不代表可读取私密帖子；资料缺失不能解释为账号没有该属性。
user_posts 按作者 username 读取帖子列表，不返回账号资料行，也不把不同互动指标合并为一种转发量。 username 使用裸用户名或 @用户名，不是个人主页显示名或帖子链接；默认请求 10 条、上限 50 条。此 action 没有已公开的日期或类型筛选参数，不承诺完整发帖历史。 id 是内容标识，code 是帖子链接中的短码，url 是可返回的链接；repost_count、quote_count、share_count 分开保存。Threads 官方把 repost、quote 与应用外分享分开，但本接口各数值是否可得需看响应，不能相加后当作去重传播人数。
post_detail 以完整帖子 url 返回单个原帖对象，适合复核一条讨论的文本、作者及可得的互动快照。 url 必填，使用 https://www.threads.com/@用户名/post/短码 这类实际帖子链接；短码 code 不是数字媒体 ID，也不能仅传作者 username 替代链接。 text、author_username、posted_at 描述原帖；comment_count 是回复计数，不是已导出的回复数。is_paid_partnership 若出现表示付费合作标记，不是付费墙或解锁订阅权限。媒体及互动字段缺失时不要补零或推断内容类型。
可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 Threads 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 7 个能力。无需信用卡。