FeedMCP

数据接口 / Pinterest

Pinterest Pin 详情 API

一个 Pin 的标题、描述、图片、外链、发布者,以及收藏、转存、评论和分享数。

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

参数

参数 类型 必填 说明
url string 二选一 Pin 链接(pinterest.com/pin/数字)
id string 二选一 Pin ID(/pin/ 后面的数字)

所有接口还支持 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/pinterest/pins/get?url=https%3A%2F%2Fwww.pinterest.com%2Fpin%2F899664463194034393%2F" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"

Python

import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/pinterest/pins/get",
    params={"url": "https://www.pinterest.com/pin/899664463194034393/"},
    headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
    timeout=30,
)
print(r.json())

JavaScript

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

MCP

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

{
  "endpoint": "pinterest.pins.get",
  "params": {
    "url": "https://www.pinterest.com/pin/899664463194034393/"
  },
  "max_price": "0.002"
}

返回示例

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

{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "item": {
      "id": "899664463194034393",
      "platform": "pinterest",
      "type": "post",
      "url": "https://www.pinterest.com/pin/899664463194034393/",
      "title": "Camping vibes at sunset",
      "text": null,
      "created_at": "2026-10-29T16:09:24.000Z",
      "author": {
        "id": "lake.camper",
        "name": "Lake Camper"
      },
      "metrics": {
        "likes": 14,
        "comments": 0,
        "shares": 4,
        "favorites": 80,
        "repins": 79
      },
      "cover": "https://i.pinimg.com/originals/aa/bb/cc.jpg",
      "link": null
    }
  },
  "page": null,
  "warnings": [],
  "meta": {
    "endpoint": "pinterest.pins.get",
    "platform": "pinterest",
    "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)。

Pinterest的其他接口

常见问题

Pinterest Pin 详情接口多少钱?

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

需要平台账号吗?

不需要,只取公开数据。

ID 或链接怎么找?

Pin 用链接 /pin/ 后面的数字,也可以直接传链接;画板用画板链接(pinterest.com/用户名/画板名/)。

怎么在 AI 里用?

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