给 AI Agent 选社交数据接口：结构化 JSON、爬虫，还是官方 OAuth（2026）

搜「最好的社交媒体数据 API」时，英文榜单通常停在 TikTok、Instagram 和 X，再加一个带 MCP 的爬虫。榜单一碰到抖音、小红书、微博就没了。旁边两个标签页，一个是给没有端点的页面准备的 Actor，一个是竞品永远不会授权的官方 OAuth 应用。这三件事不是同一份工作。这篇只帮你选接入方式。

2026-11-08 打开的 SandBase 数据接口目录 写着 113 个平台，其中社交媒体 31 个。第一排是 Twitter（47 个端点）和 TikTok（166 个）。抖音、小红书、微博在同一个社交媒体目录里，不在这前六个卡片上。下面的数字是当天各 hub 页眉的「N of N」，不是配额。这篇没有测搜索量。

SandBase /apis 社交媒体分区：Twitter、TikTok 等同余额接入（抖音 / 小红书 / 微博等在目录更深位置）。

同步 JSON 和爬虫任务、Apify、Bright Data、RapidAPI、官方 API 的架构对比，已经写在 2026 年 AI Agent 的五种社媒数据路径。平台全图在 社媒数据 API 市场地图。这里不重写那两张表。

先说结论

• 智能体要在一轮决策里拿到公开帖子、主页、评论或热搜，先用结构化 JSON 目录。没有端点覆盖的字段，再用爬虫或 Actor。要发帖、发私信，或读账号主人授权的数据，走官方 OAuth。
• 2026-11-08，一把 API 密钥能到抖音（319 个端点）、小红书（67）、微博（63）、TikTok（166）和 X（47）。检索目录和查看 schema、价格是 0 美元。符合条件的数据接口，每个组织每天共享 100 次免费调用。
• SandBase 不是这些平台的官方合作方。Cookie、注册设备和「打开 App 去发私信」的路由，不在这篇的范围内。
• TikHub、ScrapeCreators、SocialToAI、SocialiQ、Apify 和只做 X 的厂商，各自还有赢的场景。这里不排名。

什么叫进得了决策环的社交数据

听热搜、筛达人、写研究简报的智能体，对一次数据调用有四件硬要求。同一轮里返回 JSON，而不是明天早上的 CSV。要打分的字段，名字是你看过 schema 之后才写进代码的。价格在调用前看得见。竞品的公开热搜，不需要竞品自己去点同意授权。

看板败在第一件。官方分析接口败在最后一件：令牌属于授权那个账号的人。爬虫任务四件都能凑齐，然后智能体该回答的时候，任务还在队列里。

「不用平台 OAuth」只表示公开读取靠厂商的 API 密钥就够。它不等于平台背书了这家厂商，也不等于目录里每一条路由都是公开读取。

三种接入方式

先选方式，再选厂商。

结构化 JSON 目录

SandBase 的数据路由是 POST https://api.sandbase.ai/v1/api/<vendor>/<path>。请求体只放这个端点的参数。调用完成时，业务数据在 outputs[0].data。Hub 页是目录，不是请求 URL。2026-11-08 的 价格页 写明：搜目录、读 schema 和价格不扣余额。符合条件的数据接口，每个组织每天共享 100 次免费调用，00:00 UTC 重置。失败的调用不收费。模型服务另行计费，不占这 100 次。代码沙箱当时是 0 美元，有合理使用上限，调价前会先公告。

TikHub 和 SocialToAI 卖的是同一形状的数据厂商。SandBase 把模型服务和代码沙箱记在同一把 API 密钥上。那一层写在 一把密钥的 Agent 栈。

爬虫和 Actor

Apify 是一批可直接跑的工具。目录里没有的站点或字段，用 Actor。Schema 属于那个 Actor，耗时要等跑完才知道。同步还是任务式的代价，Top 5 那篇已经写过。

官方开放平台

账号主人是你的用户时，走官方。

抖音开放平台有 MCP 服务广场。功能介绍 在 2026-11-08 写着：登录开放平台账号，进入移动或网站应用，再申请。官方能力要等审批。该页写的是 5 个工作日，MCP 地址是 https://open.douyin.com/sse。这是应用审核路径，不是去读竞品没授权的公开热搜。

X API 介绍 是官方的按次付费接口，用来做应用和已登录操作。TikTok for Developers 和 微博开放平台 是同一类大门。小红书的发帖和合作电商走它自己的审核项目。这篇不编造那些站点上的公开端点清单。

买家真正会问的五个平台

抖音

抖音 hub 当天是「319 of 319」。页面覆盖搜索、用户主页、评论、直播、榜单和星图研究。展示名、数字 user id、视频 URL 都不是 sec_user_id。计数字段缺失不等于 0。单次调用怎么写，看 SandBase 上的抖音数据接口。

SandBase 抖音数据接口页：公开搜索、主页、评论等只读能力，公开读取不需要抖音 OAuth。

趋势环可以先打 douyin/app-v3/hot-search-list。参考页 在 2026-11-08 标价 0.001 美元，没有必填参数。board_type 和 board_sub_type 用来换别的榜。空请求体就是热搜榜。这篇没有实际调用。

不要把 web/web-guest-cookie、app-v3/register-device、app-v3/open-app-to-send-private-message 当成公开监测。公开热搜不需要游客 Cookie，也不需要一条私信深链。

小红书

小红书 hub 当天是「67 of 67」：热榜、笔记搜索、主页、评论、商品搜索和详情、推荐、达人增长。电商团队要的是笔记和商品讨论，不是抖音榜。

入口是 xiaohongshu/app-v2/search-notes。参考页 当天 0.01 美元，必填 keyword。翻页要把第一次返回的 search_id 和 search_session_id 带回去。页面描述里有标题、作者、封面和互动计数。打分前先对一下线上字段名。这篇没有跑这条调用。

微博

微博 hub 当天是「63 of 63」：热搜、频道趋势、用户、帖子、评论、赞、粉丝、文章和音视频元数据。

weibo/web-v2/hot-search-summary 没有必填参数。参考页 当天 0.0015 美元。字段表写了 keyword、rank、tag、is_top、heat，示例里的 heat 是空字符串。那是页面上的样本，不是这篇跑出来的解析器。空热度是缺失，不是 0。

TikTok

TikTok hub 当天是「166 of 166」，和目录卡片上的数字一致。用户、视频、音乐、搜索、评论、粉丝、话题，以及店铺侧的商品搜索，都在这页。单次调用看 SandBase 上的 TikTok 数据接口。

tiktok/app-v3/general-search-result 必填 keyword。参考页 当天 0.001 美元，可选 count、offset、publish_time、sort_type。示例负载是嵌套的，不要从示例里抄一条字段路径。公开读取不要碰 web/web-guest-cookie 和 app-v3/open-app-to-send-private-message。

X / Twitter

Twitter hub 当天是「47 of 47」，和目录卡片一致：搜索、时间线、粉丝、关注、列表、主页。公开读取用 SandBase 的 API 密钥，不用 X 开发者应用。写法在 SandBase 上的 Twitter 数据接口。

twitter/web/search-timeline 必填 keyword。search_type 可以是 Top、Latest、Media、People、Lists，默认 Top。cursor 来自上一页。参考页 当天 0.001 美元，并写着每天 100 次免费。Playground 示例用关键词 “AI agents”、类型 Top，里面有 timeline 和 next_cursor。真正的调用从 outputs[0].data 读，字段用 .get()。这篇没有按 Run。

X/Twitter search-timeline 参考页：先 inspect 看 schema 与价格再 run（公开读取无需 X 开发者 OAuth）。

twitter/web/user-profile 当天也是 0.001 美元，可选 screen_name 或 rest_id。把搜索结果里实际出现的 handle 传过去。

只做 X 的厂商就停在这里。TwitterAPI.io 在 2026-11-08 是面向开发者和智能体的公开 X 接口，用 API 密钥，首页写着最高 1 美元免费额度、不需要信用卡。他们宣传的吞吐，这篇没有测。Sorsa 是另一篇只谈 X 的文章。智能体不出 X，用他们就行。

中国社交媒体搜索 只有一个端点 cn-social/search，不是第六个同级 hub。2026-11-08 标价每次 0.028571 美元，页面上没有 100 次免费那一行。不要默认每日免费额度覆盖它。

什么时候该留在别的厂商

没有一份「最好的社交媒体数据 API」能打满所有智能体。按工作拆。

SocialToAI 已经把这些中国平台和 TikTok、X 放在一起。SandBase 的差别不是「有中国」。差别是同一把密钥上的模型服务和代码沙箱、免费查看，以及你能重新打开的 hub 计数。他们的工具列表就是你买的东西，就留在那里。

最小的发现、查看、调用

这篇写作时没有 SandBase 密钥，所以下面是文档里的请求形状，不是抓到的响应。

Claude Code、Cursor、Codex 里不要重做三份 MCP 配置。安装看 SandBase Skill / MCP 配置。配好之后，sandbase_discover 搜索，sandbase_inspect 返回 schema 和价格且不扣费，sandbase_run 才执行。慢任务用 sandbase_run_get 轮询。再打一次 sandbase_run 会再计费。要粘贴的那一行在那篇文章、SKILL.md 和 AI 工具页。

自己的进程里走 Model API 的 POST，不要走目录页的 GET：

import os
import requests

def call_api(vendor_path: str, payload: dict) -> dict:
    response = requests.post(
        f"https://api.sandbase.ai/v1/api/{vendor_path}",
        headers={
            "Authorization": f"Bearer {os.environ['SANDBASE_API_KEY']}",
            "Content-Type": "application/json",
        },
        json=payload,
        timeout=90,
    )
    response.raise_for_status()
    body = response.json()
    outputs = body.get("outputs") or []
    if body.get("status") != "completed" or not outputs or outputs[0].get("data") is None:
        raise RuntimeError(
            f"SandBase call did not complete: {body.get('status')} {body.get('error')}"
        )
    return outputs[0]["data"]

# 2026-11-08 的文档形状。这篇没有执行。
hot = call_api("douyin/app-v3/hot-search-list", {})
posts = call_api(
    "twitter/web/search-timeline",
    {"keyword": "AI agents", "search_type": "Latest"},
)

简报还要去重，同一把密钥可以开代码沙箱。首页 的演示是把 X 帖子收成一份研究简报。沙箱怎么配，留在那篇一把密钥的文章里。run id 不是业务数据。没有 outputs[0].data，上面的函数会直接抛错。

边界

公开、只读。不发帖、不关注、不点赞、不发私信，也不宣称官方合作。遵守各平台条款。Cookie、游客会话、注册设备、「打开 App 发消息」是另一种产品。文档保证的是信封，不是一个稳定的热度字段。把 319 或 47 当成固定配额之前，重新打开 hub。授权的全量 firehose、平台合同，或目录里没有的字段，应该故意去买别的产品。

常见问题

给 AI Agent 用的社交媒体数据 API，怎么选？

一轮里要公开 JSON，用结构化目录。缺字段用 Actor。发帖或读账号主人的数据，用官方 OAuth。抖音、小红书、微博、TikTok 和 X 要在同一条循环里，SandBase 的社交目录是这个形状：先免费查看，符合条件的数据接口再用完每天共享的免费次数后按次计费。先对线上价格。SocialToAI、TikHub 和只做 X 的接口，在上表那些工作里仍然更好。这是匹配，不是名次。

不用官方 OAuth，智能体能读抖音或小红书吗？

很多公开读取可以。用的是 SandBase 的 API 密钥，不是创作者的令牌。发帖、会员操作、合作电商仍走官方开放平台。返回是尽力而为，目录不是官方合作。用 Cookie 或登录去操作账号的工具，不在这篇里。

不想自己爬，也不想申请 X 开发者账号，怎么给智能体 X 的数据？

用只读的公开 X 接口。twitter/web/search-timeline 在 2026-11-08 是 0.001 美元，凭厂商密钥。TwitterAPI.io 是只做 X 的同类做法。发帖和私信留在官方 X API。

什么免费，什么要钱？

搜目录和查看 schema、价格是 0 美元。符合条件的数据接口，每个组织每个 UTC 日共享 100 次，之后按该端点标价。上面五个示例当天都有这行免费说明。cn-social/search 没有。模型服务另计。代码沙箱当时免费。失败不收费。没有订阅。Start 方案是 0 美元加起步额度。价格页没印出的额度数字，这篇不编。

什么时候不该用这些社交数据接口？

要发布或扮演已登录用户；要打分的字段线上没有；你已经在为另一家的 MCP 工具列表付钱；你需要授权的全量数据或平台合同；你找到的路由是 Cookie 或 App 深链。

接下来

打开简报点名的那个 hub，查看一个端点。页面写明这次调用在免费额度里，再跑一次小请求。字段不在，就改用 Actor 或官方 API。架构留在 Top 5 那篇，平台全图留在市场地图，Skill 安装留在 Skill 那篇，模型服务和代码沙箱留在一把密钥那篇。