Threads API

A Threads API wrapper for user profiles, posts, replies, conversations, keyword search, profile lookup, and OAuth token workflows.

原始信息汇总

好的，根据您提供的数据集详情页面内容，以下是为您提炼的关键信息概述：

数据集概述：Threads API

基本信息

• API 名称：Threads API
• 提供者：Kairox-Org
• 类别：社交 (Social)
• 当前版本：0.1.0
• 基础URL：https://threads-api-wine.vercel.app

核心功能

Threads Public API 是一个基于 Meta Threads Graph API 构建的 REST API 封装，为开发者提供用于检索 Threads 数据的 HTTP 接口。其主要功能包括：

• 用户信息：通过用户名或用户ID查找公开的个人资料。
• 帖子内容：获取用户的公开帖子、帖子详情及用户帖子流。
• 互动数据：获取用户的回复、转发（基于官方 reposted_post 字段过滤）以及帖子的评论。
• 关系链：获取帖子的相关帖子（映射到官方的对话流）以及帖子的回复（映射为评论）。
• 搜索功能：支持关键词或标签的热门和最新搜索，以及精确的用户名查找。
• OAuth 支持：提供用于授权URL、授权码交换、长期令牌交换和令牌刷新的辅助端点。

认证方式

• RapidAPI 认证：与 Threads OAuth 认证是分离的。
• Threads OAuth 认证：调用数据端点时，需要在请求头中携带一个有效的 Threads OAuth 访问令牌： X-Threads-Access-Token: YOUR_THREADS_LONG_LIVED_TOKEN。
• 服务器端令牌：部分订阅计划或部署方式可能提供服务器端令牌，此时可能无需上述请求头。

主要端点

类别	方法	端点	描述
系统	GET	healthCheck	健康检查。
用户	GET	/v1/user/info?username=threads	通过用户名获取用户信息。
	GET	/v1/user/info/{user_id}	通过用户ID获取用户信息。
	GET	/v1/user/posts?username=threads&limit=25	获取用户的公开帖子。
	GET	/v1/user/{user_id}/reposts?limit=25	获取用户的转发内容。
	GET	/v1/user/{user_id}/replies?limit=25	获取用户的回复。
帖子	GET	/v1/post/id-by-url	解析帖子URL并尝试映射到媒体ID。
	GET	/v1/post/detail?post_id=THREADS_MEDIA_ID	获取帖子的详细信息。
	GET	/v1/post/{post_id}/related?limit=25	获取相关帖子（映射到对话流）。
	GET	/v1/post/{post_id}/comments?limit=25	获取帖子的评论（映射到官方回复）。
搜索	GET	/v1/search/top?q=threads&search_mode=KEYWORD&limit=25	热门关键词或标签搜索。
	GET	/v1/search/recent?q=threads&search_mode=KEYWORD&limit=25	最新关键词或标签搜索。
	GET	/v1/search/profiles?q=threads&exact=true	精确的用户名资料查找。

分页与限制

• 分页参数：支持 limit、before、after、since、until 等标准分页参数。before 和 after 不能同时使用。
• 数据范围：数据可用性、权限、速率限制和字段支持均受官方 Threads API 及 OAuth 令牌控制。
• 权限要求：部分端点需要 Meta App 的审核权限，例如 threads_basic, threads_read_replies, threads_keyword_search。

注意事项

• 该 API 不会抓取 Threads 的网页内容。
• 评论被映射为 Threads 官方的回复，相关帖子被映射为官方的对话流。
• 个人档案搜索仅限于精确的用户名查找。