【工具分享】八大平台的免费 API 全景：官方、oEmbed、RSS 与社区通道实测

上一篇笔记研究「免费拿推文数据」时，我翻了 fxtwitter（FxEmbed）的源码，发现它的 provider 目录里躺着六个平台：twitter、bluesky、instagram、mastodon、threads、tiktok。索性把 YouTube 和 Discord 也加上，一次把主流平台盘完。

统一视角看五件事：官方 API 免费到什么程度、官方 oEmbed 免不免 token、原生 RSS 还在不在、社区通道有哪些、国内能不能直连。文中所有「实测」均在 2026-08-30 完成：本机为国内家庭宽带，服务端验证借助网页抓取服务（下文不再重复标注）。每个平台配一张 API 清单表，免费通道加粗。

总表

国内直连实测（本机）：通的有 api.fxtwitter.com、api.vxtwitter.com、api.fxbsky.app、noembed.com、api.lanyard.rest，以及个别 Mastodon 实例（联邦网络的好处）；不通的包括 X 全家（publish.x.com、pbs.twimg.com、cdn.syndication.twimg.com）、Bluesky 全家、threads.com、graph.threads.com、tiktok.com、youtube.com、mastodon.social、graph.facebook.com、discord.com。规律很直白：平台官方域名全军覆没，架在 Cloudflare 上的社区服务基本都活着。

X：上一篇的主角

结论都在上一篇，一句话版：官方 oEmbed 免费不限流但「喂浏览器」，官方 API 按量付费，结构化数据用社区方案。

Bluesky：官方就是「别人家的社区 API」

Bluesky 是八家里官方通道最慷慨的。公开只读入口 public.api.bsky.app 免 key 免注册，服务端实测 getPostThread：正文、互动数（likeCount 9343 一目了然）、嵌入媒体的 alt 文本、作者认证信息一应俱全。需要写操作时用「应用密码」（设置里生成、可撤销、可限定范围），底层是开放的 AT Protocol，甚至可以自托管 PDS 当数据源。

没有原生 RSS，订阅需求用上面的 fxbsky 或第三方补。

Mastodon：三件套全免费，还自带 RSS

Mastodon 是「开放」的基准线，官方三件套（REST、oEmbed、RSS）全部免费免 key。API 是实例级的，找一个可达实例就能用——mastodon.social 在国内被墙，但联邦网络里总有活着的，我在 mementomori.social 上完成了全链路本机实测：

# 公共时间线（免鉴权）
curl "https://mementomori.social/api/v1/timelines/public?local=true&limit=1"
# oEmbed：把任意嘟文 URL 传给 /api/oembed
curl "https://mementomori.social/api/oembed?url=https://mementomori.social/@user/117184070418133181"
# RSS：个人主页地址加 .rss 后缀
curl "https://mementomori.social/@HS_muutokset.rss"

注意「全网」视角不存在，只能按实例查询；但对「拿某人公开嘟文 / 订阅某人」这类需求，官方通道已经完备到社区方案没有存在的必要。

Threads：官方 API 门槛犹在，但 oEmbed 今年刚「免签」

Threads 的官方 API 免费但偏发布向：发帖、回复管理、insights、查询提及自己的帖子，都只能访问自己的账号；读别人的内容要走 App Review（2026 年起陆续放出了关键词搜索等读取能力，配额也放得细：发布 250 帖 / 24 小时，关键词搜索 500 次 / 7 天）。对只想嵌入展示的开发者，今年有个大变化：2026 年 3 月 3 日起 oEmbed 免 token、免审核。实测：

curl "https://graph.threads.com/v1.0/oembed?url=https://www.threads.com/@threadsapi.changelog/post/DVcNwt2jDZS/"

{
  "type": "rich",
  "version": "1.0",
  "html": "<blockquote class=\"text-post-media\" data-text-post-permalink=\"https://www.threads.com/t/DVcNwt2jDZS…\">…View on Threads…</blockquote>\n<script async src=\"https://www.threads.com/embed.js\"></script>",
  "provider_name": "Threads",
  "width": 658
}

oEmbed 的两个坑：一是 fallback HTML 是一张「View on Threads」占位卡，正文不在里面，要靠 embed.js 渲染（这点连 X 都不如，X 的 <p> 里至少有截断版正文）；二是官方文档写明用途限制：这个端点只能用于在网站/应用里嵌入展示，把返回的元数据用于提取、分析、持久化都是明确禁止的——想拿数据做归档，此路不通。

Instagram：最封闭的一家

Instagram 把门关得最死。当年给个人开发者用的 Basic Display API 已于 2024 年 12 月 4 日彻底关停；现在官方分成两条路，都要专业账号（商业/创作者）且各有审核门槛；连官方 oEmbed 端点都要 access token。网页通道也一样：游客访问基本看不到内容，og meta 时灵时不灵。

无 RSS。Meta 对社区服务的态度是持续打击，域名随时可能被夺回或屏蔽——Instagram 的嵌入方案要做好随时换域名的准备。

TikTok：oEmbed 大方，数据 API 严格分层

官方 oEmbed 是八家里最「直给」的：https://www.tiktok.com/oembed?url=<视频或主页URL>，免 key 免注册，服务端实测：

{
  "version": "1.0",
  "type": "video",
  "title": "Scramble up ur name & I'll try to guess it😍❤️ #foryoupage #petsoftiktok #aesthetic",
  "author_url": "https://www.tiktok.com/@scout2015",
  "author_name": "Scout and Suki",
  "html": "<blockquote class=\"tiktok-embed\" cite=\"https://www.tiktok.com/@scout2015/video/6718335390845095173\" …>…</blockquote>\n<script async src=\"https://www.tiktok.com/embed.js\"></script>",
  "thumbnail_url": "https://p16-tiktok-va.ibyteimg.com/obj/tos-maliva-pz0068/…?x-expires=1594850400&x-signature=…",
  "provider_name": "TikTok"
}

标题、作者、缩略图、嵌入代码一次给全。两个坑：thumbnail_url 是带签名和过期时间的（x-expires），不能当长期图床用；正文细节靠 embed.js 渲染。

YouTube：免费但全在「配额经济学」里

oEmbed 国内被墙，我经 noembed 代理实测成功，返回标准 iframe：

{
  "type": "video",
  "html": "<iframe width=\"200\" height=\"113\" src=\"https://www.youtube.com/embed/dQw4w9WgXcQ?feature=oembed\" …></iframe>",
  "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
  "provider_name": "YouTube"
}

经验法则：能拿视频 ID 就别用 search.list（一次 100 单位），oEmbed 和 RSS 能解决的就不碰配额。

Discord：全部免费，但内容是私有的

Discord 是个特例：API 免费到彻底、文档一流、限速透明（429 + X-RateLimit-* 响应头），但它是聊天平台而非内容平台——没有 oEmbed，读消息必须 Bot Token 加相应权限，公开能白嫖的只有零星端点。

几个实测细节：GET /api/v10/gateway 不带任何 token 直接返回 {"url":"wss://gateway.discord.gg"}；widget.json 对不存在的服务器返回标准错误码（10004 Unknown Guild）而不是 401，证明它就是公开端点，只是要在服务器设置里开 widget。Lanyard 是把「展示我的 Discord 状态」做成免费 API 的社区项目，返回实时活动、Spotify 歌曲甚至自定义 KV——做个人主页状态卡片的人很爱用它。注意 Webhook URL 等于完整凭证，泄露就意味着任何人都能往你频道发消息，务必当密钥管理。

通用工具层

跨平台需求还有几个「胶水」可以用：

• oembed.com 的 provider 注册表——各平台官方 oEmbed 端点的权威索引，找端点入口先看这里。
• noembed.com——免费聚合代理，一个端点对接几十家 provider，本机实测可直连（YouTube 正常返回；X 已无 provider）。
• Iframely / Embed.ly——商业聚合器，稳定省事，适合不想维护的团队。
• Meta 官方 WordPress 插件（meta-embeds-for-wordpress）——WordPress 用户直接用。

三个梯队（外加一个特例）

把八个平台放在一起，格局立刻清晰：

1. 完全开放（Mastodon、Bluesky）：官方 API 免费免 key，RSS 是标配或近似标配。开放协议的去中心化平台，把「别人家的社区 API」做成了自己的官方 API。
2. 半开放（YouTube、TikTok、Threads）：官方给免费通道，但各有一道门槛——YouTube 是配额经济学，TikTok 是 oEmbed 大方、数据 API 分层，Threads 是发布自由、读取要审核。
3. 封闭（X、Instagram）：官方通道收费或高墙，逼出了最繁荣的社区生态——fxtwitter 五千 star、InstaFix 全家桶，都是被需求推出来的。
4. 特例（Discord）：免费且官方文档一流，但内容本身是私有空间——API 围绕 bot 和 webhook 展开，公开可白嫖的只有网关查询、widget 和社区的 Lanyard。

选型上：做嵌入优先各平台官方 oEmbed（Threads 今年也免签了；国内受众注意 iframe 和 embed.js 全在墙外，要么截图要么走社区 OG 页）；拿数据 Mastodon / Bluesky 直接官方，X 用 fxtwitter，YouTube 用「RSS + oEmbed」组合拳（多数场景碰不到配额）；订阅时间线用 Mastodon 的 .rss、YouTube 的 feed.xml、X 的 fxtwitter.com/<user>/feed.xml（上篇实测过）；给 Discord 发通知一个 webhook 足矣。

风险清单

• Threads oEmbed 的用途限制条款：只许展示，不许提取元数据做分析或持久化——用它做归档是违反条款的。
• TikTok 缩略图签名时效：x-expires 过了就 403，重要图片要立刻转存。
• YouTube 配额按太平洋时间午夜重置，跨时区排任务要注意。
• Discord webhook URL 即凭证，泄露等于频道被任意发消息。
• Instagram 社区域名随时会死（Meta 持续打击），X 的社区接口随时可能断供（Nitter 收律师函的前车之鉴见上篇）——社区域名只当展示用，不当数据源依赖。
• 一切免 key 通道都没有 SLA：能缓存就缓存，能落盘就落盘。

参考链接

• Bluesky 开发者文档｜Jetstream 官方文档｜FxEmbed 文档
• Mastodon API 文档｜Mastodon oEmbed 说明｜instances.social API
• Threads API 文档｜Threads oEmbed：嵌入帖子｜2026-04 官方更新博客（tokenless oEmbed）｜meta-embeds-for-wordpress
• Instagram 平台总览｜Basic Display API 关停公告（2024-09）｜Instagram oEmbed 文档
• TikTok oEmbed：嵌入视频｜Content Posting API｜Research API
• YouTube Data API 配额计算器｜配额与合规审计｜频道 RSS 说明
• Discord 开发者文档｜限速说明｜Guild Widget 端点｜Lanyard（GitHub）
• oEmbed 官方注册表｜noembed