Pinterest API

Pinterest 搜索 API

按关键词搜索 Pinterest,获取 Pin、视频、图板或主页结果,包含标题、图片和链接。

US$0.80/千次请求,按请求付费,无需订阅。

mid-century living room | Pinterest
pinterest.com/search/pins/
mid-century living roomLog inSign up
IdeasDecor ideasModernMinimalist designVintage accents
Save

Warm mid-century living room with walnut credenza

Living Room Ideas

API 返回的内容items[0]
{
"id": "998271640023841902",
"url": "https://www.pinterest.com/pin/998271640023841902/",
"title": "Warm mid-century living room with walnut credenza",
"description": "A sunlit living room mixing walnut furniture, a boucle sofa, and brass accents for a warm mid-century look.",
"image": "https://i.pinimg.com/736x/4a/2b/9c/midcentury-living-room.jpg",
"pinner": {...},
"boardName": "Living Room Ideas",
"domain": "havenandhearth.com",
... 还有 4 个字段
}
可用率
99.96%
30d · 14,347 次调用
请求数
14,551
30d · 按周,近 12 周
响应时间
4.1s
中位数 · 30d

价格与服务商

Pinterest 搜索 API 价格:一个 API,2 个可互换的服务商

最便宜的服务商优先响应。如果它失败,下一个会在同一次调用中接手。

你需支付
US$8.00
US$0.80/千次请求,只为实际用量付费。没有月度套餐。
有了 US$0.10 的初始余额,你的前 125 次请求免费。

试一试

一个请求获取 Pinterest 搜索

requireFieldsarray
可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `description` 或 `videoUrl`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某个 Pin 确实没有某个列出的字段,该字段仍可能为 null。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。
打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。

这个示例展示了 13 个字段中的 9 个。查看全部字段

{
  "found": true,
  "data": {
    "items": [
      {
        "id": "998271640023841902",
        "url": "https://www.pinterest.com/pin/998271640023841902/",
        "title": "Warm mid-century living room with walnut credenza",
        "description": "A sunlit living room mixing walnut furniture, a boucle sofa, and brass accents for a warm mid-century look.",
        "image": "https://i.pinimg.com/736x/4a/2b/9c/midcentury-living-room.jpg",
        "pinner": {
          "username": "havenandhearth",
          "displayName": "Haven & Hearth Design"
        },
        "boardName": "Living Room Ideas",
        "domain": "havenandhearth.com",
        "saveCount": 4820
      },
      {
        "id": "672190384710025612",
        "url": "https://www.pinterest.com/pin/672190384710025612/",
        "title": "Sunken living room, 1962 case study house",
        "description": "Archival photo of a sunken conversation pit living room from a 1962 case study house.",
        "image": "https://i.pinimg.com/736x/7f/1e/33/case-study-house.jpg",
        "pinner": {
          "username": "modernarchive",
          "displayName": "Modern Archive"
        },
        "boardName": "Retro Interiors",
        "domain": "modernarchive.com",
        "saveCount": 12300
      },
      {
        "id": "554098271640023841",
        "url": "https://www.pinterest.com/pin/554098271640023841/",
        "title": "DIY mid-century TV console makeover",
        "description": "Step by step refinish of a thrifted teak console with new hairpin legs.",
        "image": "https://i.pinimg.com/736x/9b/44/12/tv-console-diy.jpg",
        "pinner": {
          "username": "thriftandtinker",
          "displayName": "Thrift & Tinker"
        },
        "boardName": "Furniture Flips",
        "domain": "thriftandtinker.com",
        "saveCount": 2190
      }
    ],
    "nextCursor": "QVFEc2ZncnRlaHRjS3ZaWA=="
  }
}

完整的参数与响应参考:这个接口的每个字段、类型和示例。

参考

一个请求,一种响应结构。

你发送的每个字段和收到的每个字段,都附有真实示例。

最近验证于 2026-11-14 · 可用率和延迟按 30d 统计

请求体

JSON,POST 到这个接口。

  • querystring

    mid-century living room

    要在 Pinterest 上搜索的关键词、话题、品牌或主题(例如 mid-century living room)。

  • cursorstring

    来自上一次响应 nextCursor 的不透明分页游标。获取第一页时省略。

  • limitinteger

    3

    Page size to ask for (1-20). Some sources return their whole page of about 20 pins whatever limit says: a page is never trimmed after the call, so nextCursor continues exactly where this response ended.

  • requireFieldsarray

    可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `description` 或 `videoUrl`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某个 Pin 确实没有某个列出的字段,该字段仍可能为 null。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。

  • typeenum

    要返回的结果类型:全部 Pin、仅视频 Pin、图板或主页(例如 videos)。

你发送。 一个简短的 JSON 请求体。显示的值只是示例,请换成你自己的。

响应

JSON,每个字段一个示例值。

each itemdata.items[]

Matching Pinterest records: pin or board title, description, image/video URL, creator, and link. Populated whenever the provider has data for the entity.

  • authorstring

    Username (handle) of the account that saved the pin.

  • authorNamestring

    Display name of the account that saved the pin.

  • descriptionstring可设为必填

    A sunlit living room mixing walnut furniture, a boucle sofa, and brass accents for a warm mid-century look.

    The pin's full description text, or null when the source does not provide it.

  • idstring

    998271640023841902

  • imagestring

    https://i.pinimg.com/736x/4a/2b/9c/midcentury-living-room.jpg

    URL of the pin's full-size image; for a video pin, its cover image.

  • titlestring

    Warm mid-century living room with walnut credenza

    Pin title, or the pin's description when the pin has no title.

  • urlstring

    https://www.pinterest.com/pin/998271640023841902/

    Populated whenever the provider has data for the entity.

  • videoUrlstring可设为必填

    Streaming (HLS) URL of the pin's video, or null when the pin is not a video or the source does not provide it.

datadata
  • nextCursorstring

    QVFEc2ZncnRlaHRjS3ZaWA==

    Opaque cursor for the next page of results, or null/empty when there are no more. Pass it back as cursor to continue.

top level
  • foundboolean

    true

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

你收到。 字段有名称、有类型,无论哪个数据源响应,结构都一样。

常见问题

关于 Pinterest 搜索 API

AnyAPI 的 Pinterest 搜索 API 只需一次 POST 请求 /v1/run/pinterest.search,就以统一格式的 JSON 返回 Pinterest 数据。按关键词搜索 Pinterest,获取 Pin、视频、图板或主页结果,包含标题、图片和链接。AnyAPI 会在 2 个数据源之间路由每个请求,某个数据源失败时自动切换。费用:每千次请求 US$0.80 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 Pinterest 搜索 API 调用中有 100.0% 成功,响应时间中位数为 4.1 秒,共测量 14,347 次调用。

费用:每千次请求 US$0.80 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。

按关键词搜索 Pinterest,获取 Pin、视频、图板或主页结果,包含标题、图片和链接。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

过去 30 天,通过 AnyAPI 发起的 Pinterest 搜索 API 调用中有 100.0% 成功,响应时间中位数为 4.1 秒,共测量 14,347 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。

可以。新的 AnyAPI 账户自带 US$0.10 免费余额,无需绑卡,足够调用 125 次 Pinterest 搜索,每次 US$0.0008。

AnyAPI 会在同一个请求中依次尝试它的 2 个数据源,从最便宜的开始,所以一个数据源宕机不会让你的调用失败。

向 https://api.getanyapi.com/v1/run/pinterest.search 发送 POST 请求,在 “Authorization: Bearer” 请求头中放入你的 AnyAPI 密钥,并以 JSON 请求体传入参数。同一个密钥和同一个钱包适用于所有 AnyAPI 接口。

不需要。你向一个预付费的 AnyAPI 余额充值美元,每个请求从中扣费。没有月度套餐,也没有最低消费,同一个余额可用于所有 AnyAPI 接口。

有。TypeScript 用 npm 安装 @getanyapi/sdk,Python 用 pip 安装 getanyapi。两者都用同一个密钥调用所有 AnyAPI 接口,任何 HTTP 客户端也都可以。

可以。智能体可以连接 https://api.getanyapi.com/mcp 上的 AnyAPI MCP 服务器,或者向 https://api.getanyapi.com/agent/signup 发送一次无需认证的 POST 来创建自己的免费试用密钥,再通过 HTTP 调用这个接口。