FeedMCP

数据接口 / Threads

Threads 帖子详情 API

一条帖子的正文、图片、作者,以及点赞、回复、转发和引用数。

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

只给短码时,按 threads.com/post/短码 去取;如果取不到,请传完整链接。

参数

参数 类型 必填 说明
url string 二选一 帖子链接(threads.com 或 threads.net)
id string 二选一 帖子短码(链接 /post/ 后面那一串)

所有接口还支持 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.003。对象不存在、没取到数据、参数错误、平台出错、超时都不收费。

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

调用示例

cURL

curl "https://api.feedmcp.com/v1/threads/posts/get?url=https%3A%2F%2Fwww.threads.com%2F%40beckylouise66%2Fpost%2FDf2f5lKiFDy" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"

Python

import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/threads/posts/get",
    params={"url": "https://www.threads.com/@beckylouise66/post/Df2f5lKiFDy"},
    headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
    timeout=30,
)
print(r.json())

JavaScript

const res = await fetch("https://api.feedmcp.com/v1/threads/posts/get?url=https%3A%2F%2Fwww.threads.com%2F%40beckylouise66%2Fpost%2FDf2f5lKiFDy", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());

MCP

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

{
  "endpoint": "threads.posts.get",
  "params": {
    "url": "https://www.threads.com/@beckylouise66/post/Df2f5lKiFDy"
  },
  "max_price": "0.003"
}

返回示例

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

{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "item": {
      "id": "Df2f5lKiFD1",
      "platform": "threads",
      "type": "post",
      "url": "https://www.threads.com/@frost.camper/post/Df2f5lKiFD1",
      "title": null,
      "text": "First frost on the tent this morning 1",
      "created_at": "2025-11-18T20:06:40.000Z",
      "author": {
        "id": "frost.camper",
        "name": "Frost Camper",
        "avatar": "https://scontent.cdninstagram.com/a.jpg"
      },
      "metrics": {
        "likes": 355,
        "comments": 12,
        "shares": 3,
        "quotes": 1
      },
      "cover": "https://scontent.cdninstagram.com/p.jpg"
    }
  },
  "page": null,
  "warnings": [],
  "meta": {
    "endpoint": "threads.posts.get",
    "platform": "threads",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.003",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}

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

Threads的其他接口

常见问题

Threads 帖子详情接口多少钱?

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

需要平台账号吗?

不需要,只取公开数据。

ID 或链接怎么找?

帖子用链接(threads.com/@用户名/post/短码),也可以只传短码;账号用用户名(不带 @)。

怎么在 AI 里用?

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