FeedMCP

数据接口 / X(Twitter)

X 对话串 API

一条帖子所在的整个对话:它回复的上文和下面的回复,每页条数由 X 决定(常见 20–40 条,最多 50 条)。

项目 值
地址 GET https://api.feedmcp.com/v1/x/posts/thread/list
ID x.posts.thread.list
价格 $0.0003/条(每次 $0.0003–0.015)
返回 一页 内容(帖子)对象列表
认证 Authorization: Bearer $FEEDMCP_API_KEY

每页条数由 X 决定,常见 20–40 条,所以单价比其他 X 列表高一些。第一条通常是对话的开头。

参数

参数 类型 必填 说明
id string 二选一 帖子 ID(链接 /status/ 后面的数字)
url string 二选一 帖子链接
cursor string 否 翻页游标。第一页不传;下一页传上一页返回的 page.next_cursor。每一页单独计费

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

返回字段

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

字段 类型 说明
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.0003,每次至少 $0.0003、最多 $0.015,扣了多少写在返回的 meta.billing 里(items 是条数)。空结果不收费。参数错误、平台出错、超时都不收费。

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

调用示例

cURL

curl "https://api.feedmcp.com/v1/x/posts/thread/list?id=1937965171194167625" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"

Python

import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/x/posts/thread/list",
    params={"id": "1937965171194167625"},
    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/thread/list?id=1937965171194167625", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());

MCP

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

{
  "endpoint": "x.posts.thread.list",
  "params": {
    "id": "1937965171194167625"
  },
  "max_price": "0.015"
}

返回示例

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

{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "items": [
      {
        "id": "2123584023813398551",
        "platform": "x",
        "type": "post",
        "url": "https://x.com/trail_mia/status/2123584023813398551",
        "title": null,
        "text": "Best campsite this year 1",
        "created_at": "2026-11-20T01:07:40.000Z",
        "author": {
          "id": "trail_mia",
          "name": "Trail Mia",
          "avatar": "https://pbs.twimg.com/a.jpg"
        },
        "metrics": {
          "views": 114,
          "likes": 3,
          "comments": 0,
          "shares": 1,
          "quotes": 0,
          "favorites": 0
        },
        "cover": null
      },
      {
        "id": "2123584023813398552",
        "platform": "x",
        "type": "post",
        "url": "https://x.com/trail_mia/status/2123584023813398552",
        "title": null,
        "text": "Best campsite this year 2",
        "created_at": "2026-11-20T01:07:40.000Z",
        "author": {
          "id": "trail_mia",
          "name": "Trail Mia",
          "avatar": "https://pbs.twimg.com/a.jpg"
        },
        "metrics": {
          "views": 114,
          "likes": 3,
          "comments": 0,
          "shares": 1,
          "quotes": 0,
          "favorites": 0
        },
        "cover": null
      }
    ]
  },
  "page": {
    "next_cursor": "eyJjdXJzb3IiOjIwfQ",
    "has_more": true
  },
  "warnings": [],
  "meta": {
    "endpoint": "x.posts.thread.list",
    "platform": "x",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.0006",
      "currency": "USD",
      "balance": "9.99",
      "unit": "item",
      "items": 2,
      "price_per_item": "0.0003"
    }
  }
}

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

X(Twitter)的其他接口

常见问题

X 对话串接口多少钱?

按返回的条数收费:每条 $0.0003,每次至少 $0.0003、最多 $0.015,扣了多少写在返回的 meta.billing 里(items 是条数)。空结果不收费。参数错误、平台出错、超时都不收费。

需要平台账号吗?

不需要,只取公开数据。

ID 或链接怎么找?

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

怎么取更多条?

返回里有 page.next_cursor 时,把它作为 cursor 参数传回来取下一页。每一页单独计费。

怎么在 AI 里用?

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