FeedMCP

数据接口 / X(Twitter)

X 长文 API

一条帖子附带的 X 长文(Article):标题、全文、封面、作者,以及浏览、点赞、回复和引用数。

项目 值
地址 GET https://api.feedmcp.com/v1/x/posts/article/get
ID x.posts.article.get
价格 $0.002 / 次
返回 一个 内容(帖子)对象
认证 Authorization: Bearer $FEEDMCP_API_KEY

只适用于分享了 X 长文(Article)的帖子;普通帖子返回「对象不存在」,不收费。text 是全文,段落之间空一行。

参数

参数 类型 必填 说明
id string 二选一 分享长文的那条帖子的 ID(链接 /status/ 后面的数字)
url string 二选一 帖子链接

所有接口还支持 view=full:在返回里附上平台的原始数据(raw),价格不变。

返回字段

data.item 是一个「内容(帖子)」对象,所有平台字段相同:

字段 类型 说明
id string 平台上的 ID,可以直接传给这个平台的详情接口:TikTok、抖音作品 ID,YouTube 视频 ID,Instagram、Threads 短码,X 帖子 ID,Telegram「频道/编号」,Reddit 短 ID,LinkedIn 帖子的 activity 数字,Pinterest Pin 数字 ID,快手 3x 开头的作品 ID,视频号作品 ID,知乎回答、问题或文章 ID,小红书笔记 ID,BV 号,微博 ID,公众号文章 ID
platform string 平台:tiktok、youtube、instagram、x、threads、telegram、reddit、linkedin、facebook、pinterest、xiaohongshu、douyin、kuaishou、wechat_mp、wechat_channels、weibo、zhihu、bilibili
type string video 视频、note 图文笔记、article 文章、post 帖子(微博、X、Threads、Telegram、Reddit、LinkedIn、Facebook、Pinterest、Instagram 图片帖)、question 知乎问题、answer 知乎回答
url string 原文链接
title string | null 标题(YouTube、Reddit、Pinterest、B 站、小红书、公众号有;知乎回答是所属问题的标题;其他平台为 null)
text string | null 正文或文案
created_at string | null 发布时间,ISO 8601,UTC
author.id string | null 作者 ID,可以直接传给这个平台的账号接口
author.name string | null 作者昵称
metrics.views number | null 播放或阅读数(平台不公开时为 null)
metrics.likes number | null 点赞数(Reddit 是得分,Facebook 是表情回应总数)
metrics.comments number | null 评论数
metrics.shares number | null 分享或转发数(X 是转帖数)
metrics.quotes number | null 引用数(X、Threads)
metrics.reactions number | null 表情回应总数(只有 Telegram)
metrics.answers number | null 回答数(只有知乎问题)
metrics.upvote_ratio number | null 点赞比例,0 到 1(只有 Reddit)
metrics.repins number | null 转存数(只有 Pinterest)
metrics.favorites number | null 收藏数(X 是书签数,Pinterest 是保存数)
cover string | null 封面图地址
duration_seconds number | null 视频时长(秒)
tags string[] 话题标签(Reddit 是帖子的分类标签)
community string | null 所在版块(只有 Reddit)
link string | null Pin 指向的网页(只有 Pinterest)

什么时候扣费

成功取到数据一次 $0.002。对象不存在、没取到数据、参数错误、平台出错、超时都不收费。

每次返回的 meta.billing 里写着这次扣了多少、还剩多少余额。

调用示例

cURL

curl "https://api.feedmcp.com/v1/x/posts/article/get?id=1905545699552375179" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"

Python

import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/x/posts/article/get",
    params={"id": "1905545699552375179"},
    headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
    timeout=30,
)
print(r.json())

JavaScript

const res = await fetch("https://api.feedmcp.com/v1/x/posts/article/get?id=1905545699552375179", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());

MCP

在装好 FeedMCP 的 AI 里,调用 call 工具:

{
  "endpoint": "x.posts.article.get",
  "params": {
    "id": "1905545699552375179"
  },
  "max_price": "0.002"
}

返回示例

示例数据是虚构的,格式和真实返回一致。

{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "item": {
      "id": "1905545699552375179",
      "platform": "x",
      "type": "article",
      "url": "https://x.com/trail_mia/status/1905545699552375179",
      "title": "How we plan a winter trip",
      "text": "Three things to check before you go.\n\nThen pack light.",
      "created_at": "2025-03-28T09:01:12.000Z",
      "author": {
        "id": "trail_mia",
        "name": "Trail Mia",
        "avatar": null
      },
      "metrics": {
        "views": 44392,
        "likes": 156,
        "comments": 16,
        "quotes": 8
      },
      "cover": "https://pbs.twimg.com/media/a.jpg"
    }
  },
  "page": null,
  "warnings": [],
  "meta": {
    "endpoint": "x.posts.article.get",
    "platform": "x",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.002",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}

出错时的格式见 错误码:每个错误都写明扣没扣钱(charged)和能不能重试(retry)。

X(Twitter)的其他接口

常见问题

X 长文接口多少钱?

成功取到数据一次 $0.002。对象不存在、没取到数据、参数错误、平台出错、超时都不收费。

需要平台账号吗?

不需要,只取公开数据。

ID 或链接怎么找?

帖子 ID 是链接 /status/ 后面的数字;账号用用户名(@ 后面那一串,不带 @)。

怎么在 AI 里用?

装好 MCP 后直接说你要什么,AI 会调用 x.posts.article.get。