万有引擎
搜索⌘K
中文
登录免费开始

社交内容 · 数据 API

Pinterest

Pinterest API

从 Pinterest Pin 搜索进入单条详情，或按用户与画板整理收藏内容；保留图片、视频和站外来源链接，便于核对灵感出处与画板主题。 调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次；失败不计费。

免费开始 看文档

7

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Pinterest 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordcontent_type默认 20 · 最多 50同步$1.39 / 千次id · url · title · text · image_url · reaction_count · source_domain · dominant_color · posted_at · author_username · author_name · author_follower_count · board_name · platform
profileusername——同步$1.39 / 千次user_id · username · name · bio · avatar_url · follower_count · following_count · pin_count · board_count · video_count · website · is_verified · is_private · created_at · platform
user_postsusername—默认 20 · 最多 50同步$1.39 / 千次id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform
pinurl——同步$1.39 / 千次id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform
boardsusername—默认 20 · 最多 50同步$1.39 / 千次id · name · url · description · pin_count · section_count · follower_count · cover_image_url · is_collaborative · privacy · owner_username · owner_name · created_at · platform
board_pinsboard_id—默认 20 · 最多 50同步$1.39 / 千次id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform
board_detailurl——同步$1.39 / 千次id · name · url · description · pin_count · section_count · follower_count · cover_image_url · is_collaborative · privacy · owner_username · owner_name · created_at · platform

Pinterest 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

怎么调用 Pinterest 主页或对象详情 API？

profile

使用 platform="pinterest"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 user_id、username、name、bio、avatar_url、follower_count 等 15 个字段。

Pinterest profile 的参数分别是什么意思？

username必填
profile / user_posts / boards 的 Pinterest 用户短名，可带开头的 @；此字段不解析完整主页 URL。

官方说明 username 构成唯一的 Pinterest 个人资料网址，资料页可呈现 Pins、boards、followers、名称、头像和简介等；私密资料不可公开读取，官方授权账户能力也不能外推为任意 username 的完整资料。官方来源：Pinterest：username 与个人资料网址来源核查：

Pinterest 特有返回字段与含义（4）
board_count
画板数。
pin_count
Pin 数。
is_private
是否私密。
video_count
视频数。

怎么调用 Pinterest 用户内容 API？

user_posts

使用 platform="pinterest"、action="user_posts" 调用“用户内容”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 id、url、title、text、image_url、video_url 等 21 个字段。

官方说明图像 Pin 可以由上传图片或保存站外图片创建，站外保存可保留原站链接。因此账号相关 Pin 与原创作品不能直接等同，来源核对也不替代内容使用许可。官方来源：Pinterest：保存的 Pin 不一定是账号原创内容来源核查：

Pinterest user_posts 的参数分别是什么意思？

username必填
profile / user_posts / boards 的 Pinterest 用户短名，可带开头的 @；此字段不解析完整主页 URL。
Pinterest 特有返回字段与含义（9）
board_name
画板名称。Pinterest 的收藏单位是画板(board)。
reaction_count
表情回应数。
dominant_color
主色调（十六进制），做视觉分析可直接用。
source_domain
内容来源域名。
repin_count
被转存(repin)次数。Pinterest 的核心传播指标。
alt_text
图片替代文本。
external_link
Pin 指向的外部链接。
media_type
媒体类型。
video_url
视频链接。

怎么调用 Pinterest 单条 Pin API？

pin

使用 platform="pinterest"、action="pin" 调用“单条 Pin”能力；返回单个对象，主要包含 id、url、title、text、image_url、video_url 等 21 个字段。

官方说明商品 Pin 可引导访问零售商网站，部分富媒体 Pin 会同步商品资料。本页仅返回实际取得的 Pin 字段，不承诺取得实时库存、下单能力或交易数据。官方来源：Pinterest：商品 Pin 的零售商链接来源核查：

Pinterest pin 的参数分别是什么意思？

url必填
pin 使用含 /pin/数字ID/ 的具体 Pin 链接；board_detail 使用 /用户名/画板名/ 的画板链接，后者也接受相对路径。不能把画板 URL 当成 Pin。
Pinterest 特有返回字段与含义（9）
board_name
画板名称。Pinterest 的收藏单位是画板(board)。
reaction_count
表情回应数。
dominant_color
主色调（十六进制），做视觉分析可直接用。
source_domain
内容来源域名。
repin_count
被转存(repin)次数。Pinterest 的核心传播指标。
alt_text
图片替代文本。
external_link
Pin 指向的外部链接。
media_type
媒体类型。
video_url
视频链接。

怎么调用 Pinterest 画板列表 API？

boards

使用 platform="pinterest"、action="boards" 调用“画板列表”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 id、name、url、description、pin_count、section_count 等 14 个字段。

Pinterest 用 board section 在同一画板内整理 Pin，分区是画板内部组织方式。这里的 section_count 因此不应当作画板数；引用创建分区教程不意味着本接口能创建、移动或编辑内容。官方来源：Pinterest：画板与画板分区的层级来源核查：

Pinterest boards 的参数分别是什么意思？

username必填
profile / user_posts / boards 的 Pinterest 用户短名，可带开头的 @；此字段不解析完整主页 URL。
Pinterest 特有返回字段与含义（7）
pin_count
Pin 数。
section_count
画板分区数。
is_collaborative
是否为多人协作画板。
privacy
可见性设置。
owner_name
所有者昵称。
owner_username
所有者用户名。
cover_image_url
封面图。

怎么调用 Pinterest 画板内容 API？

board_pins

使用 platform="pinterest"、action="board_pins" 调用“画板内容”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 id、url、title、text、image_url、video_url 等 21 个字段。

Pinterest board_pins 的参数分别是什么意思？

board_id必填
board_pins 的画板数字 ID，可从 boards 的画板结果获取；不是画板名称或 URL。

官方说明 Pin 可在画板内部放入分区。这里的 board_id 仍只定位画板；官方教程不提供本接口的 ID 转换能力，也不代表已开放分区查询参数。官方来源：Pinterest：按画板组织 Pin，不混淆分区来源核查：

Pinterest 特有返回字段与含义（9）
board_name
画板名称。Pinterest 的收藏单位是画板(board)。
reaction_count
表情回应数。
dominant_color
主色调（十六进制），做视觉分析可直接用。
source_domain
内容来源域名。
repin_count
被转存(repin)次数。Pinterest 的核心传播指标。
alt_text
图片替代文本。
external_link
Pin 指向的外部链接。
media_type
媒体类型。
video_url
视频链接。

怎么调用 Pinterest 画板详情 API？

board_detail

使用 platform="pinterest"、action="board_detail" 调用“画板详情”能力；返回单个对象，主要包含 id、name、url、description、pin_count、section_count 等 14 个字段。

Pinterest board_detail 的参数分别是什么意思？

url必填
pin 使用含 /pin/数字ID/ 的具体 Pin 链接；board_detail 使用 /用户名/画板名/ 的画板链接，后者也接受相对路径。不能把画板 URL 当成 Pin。

官方说明私密画板仅对所有者及其邀请的人可见。即使知道画板链接或 ID，也不能把它解释成访问许可；本页不提供绕过私密设置的能力。官方来源：Pinterest：私密画板的可见范围来源核查：

Pinterest 特有返回字段与含义（7）
pin_count
Pin 数。
section_count
画板分区数。
is_collaborative
是否为多人协作画板。
privacy
可见性设置。
owner_name
所有者昵称。
owner_username
所有者用户名。
cover_image_url
封面图。
Pinterest search 调用流程一次 Pinterest search 调用的全过程：向 POST /api/v1/social 发送 platform="pinterest"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、text、image_url 等字段；返回列表，单次最多 50 条，计费 $1.39 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "pinterest"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表idurltitletextimage_url
一次 Pinterest search 调用的全过程：向 POST /api/v1/social 发送 platform="pinterest"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、text、image_url 等字段；返回列表，单次最多 50 条，计费 $1.39 / 千次，失败与空结果不计费。

Pinterest 原始字段名

EveryInfra 统一字段名

左边是 Pinterest 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

Pinterest 的独有字段名（当前目录）

全站 89 个平台的当前目录中，这 12 个字段名只在 Pinterest 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

  • reaction_count
  • dominant_color
  • board_name
  • pin_count
  • board_count
  • external_link
  • repin_count
  • alt_text
  • section_count
  • is_collaborative
  • privacy
  • owner_username

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields

id
该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url
该记录在原平台上的可访问链接。
title
标题。平台无标题概念时（如纯文本帖）为 null。
text
正文内容，已去除 HTML 标签。长文可能被截断。
image_url
图片链接。多图能力可能返回 image_urls 数组。
reaction_count
表情回应数。
source_domain
内容来源域名。
dominant_color
主色调（十六进制），做视觉分析可直接用。
posted_at
发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
author_username
作者用户名（@handle），通常可用于拼 URL。
author_name
作者昵称（显示名）。
author_follower_count
作者粉丝数。null 表示不公开。
board_name
画板名称。Pinterest 的收藏单位是画板(board)。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
user_id
用户在原平台的唯一 ID。
username
用户名（@handle）。
name
名称。用于账号/商品/商家类能力，指该对象本身的名字。
bio
个人简介，账号自己填写的文本。可能含换行和 emoji。
avatar_url
头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。
follower_count
粉丝数。null 表示不公开，不等于 0。
following_count
关注数。null 表示不公开，不等于 0。
pin_count
Pin 数。
board_count
画板数。
video_count
视频数。
website
账号或商家填写的外链网址。
is_verified
是否为平台认证账号（蓝V等）。null 表示无法判定。
is_private
是否私密。
created_at
创建时间，格式同 posted_at。
video_url
视频链接。
media_type
媒体类型。
external_link
Pin 指向的外部链接。
repin_count
被转存(repin)次数。Pinterest 的核心传播指标。
comment_count
评论数。null 表示不公开，不等于 0。
share_count
分享/转发数。null 表示不公开，不等于 0。
alt_text
图片替代文本。
price
价格数值，不含货币符号；币种见 currency。
description
简介或描述，通常比 text 短。
section_count
画板分区数。
cover_image_url
封面图。
is_collaborative
是否为多人协作画板。
privacy
可见性设置。
owner_username
所有者用户名。
owner_name
所有者昵称。

请求填写示例

这里填写灵感主题词；结果类型由 content_type 选择，画板与账号资料不能混作同一对象。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

pinterest_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"pinterest","action":"search","params":{"keyword":"small balcony garden"}}'

记录字段预览（非真实响应）

仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "id": null,
  "url": null,
  "title": null,
  "text": null,
  "image_url": null,
  "reaction_count": null,
  "source_domain": null,
  "dominant_color": null,
  "posted_at": null,
  "author_username": null,
  "author_name": null,
  "author_follower_count": null,
  "board_name": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

按视觉主题检索 Pinterest Pin，并识别搜索类型边界

用 search 找到 Pin，再按 Pin 链接继续核对详情。

查看 search 的 content_type 参数 →
  • keyword 是主题词；content_type=all_pins_visual_posts 表示不限媒体形态的 Pin 搜索，不代表全量结果，videos_video_pins 表示视频 Pin 筛选。搜索只整理 Pin 字段，image_url 是图片地址，source_domain 是来源域名，不是视频播放地址。
  • 画板集合和创作者主页已从 search 的公开取值中移除，因为当前结果处理只保留 Pin 对象。已知用户名时请分别使用 boards / profile；视频筛选效果也尚未逐项用付费真实调用验证。

按 Pinterest 用户短名核对主页资料

用 profile 区分账号资料、Pin 数量和画板数量。

查看 profile 的 username 参数 →
  • username 填主页中的用户短名，可带开头的 @，不填完整主页链接；返回 user_id 是账号标识，username / name 分别是用户名与显示名称。
  • pin_count、board_count、video_count 分别表示 Pin、画板和视频数量，follower_count 不是粉丝名单。is_verified 可能来自商家或身份验证信号，缺失不补 false；is_private 也不赋予读取私密内容的权限。

整理 Pinterest 用户的 Pin 与外部来源

用 user_posts 建立账号相关 Pin 索引，不把收藏条目全部当作原创作品。

查看 user_posts 的 username 参数 →
  • username 指定用户短名；返回 id / url 定位 Pin，author_username 与 board_name 保留作者及画板线索。Pin 可以来自保存的站外内容，账号关联不证明该账号持有全部内容版权。
  • image_url、video_url、media_type 按实际返回记录；external_link 是 Pin 指向的站外页面，source_domain 是来源域名。repin_count、reaction_count 与 comment_count 不是同一种互动，也不能相加后当作独立用户数。

读取单条 Pinterest Pin 的媒体和落地链接

用 pin 核对一条视觉书签，不把商品 Pin 当成成交记录。

查看 pin 的 url 参数 →
  • url 使用含 /pin/数字ID/ 的具体 Pin 链接，不是 /用户名/画板名/ 的画板地址，也不承诺解析任意短链接；当前公开必填项是 url，不能只提交 Pin 数字 ID。
  • external_link 与 source_domain 用于追溯站外来源，image_url / video_url 是各自媒体链接。price 如有返回是 Pin 携带的价格信息，可能缺失，不是已成交价格或库存保证；是否可以买到仍需核对零售商页面。

先列 Pinterest 画板，再用数字 ID 读取收藏

用 boards 找到账号下的画板对象，避免拿名称替代后续查询 ID。

查看 boards 的 username 参数 →
  • username 填用户短名；返回 id 是 board_pins 所需的 board_id，name 是画板标题，url 是 board_detail 可使用的地址，三者不能互换。
  • pin_count 统计 Pin，section_count 统计画板内部的分区，分区不是另一位用户或另一块画板。privacy 与 is_collaborative 只描述返回对象；列表不保证包含私密画板，也不意味着可以加入或修改协作画板。

按 Pinterest 画板 ID 读取其中的 Pin

用 board_pins 把一个画板下的条目整理到同一份索引。

查看 board_pins 的 board_id 参数 →
  • board_id 是 boards 返回的数字 id，不填画板标题、URL 或 section 名称；返回 id / url 对应单条 Pin，不是画板 ID。目前没有按分区 ID 单独读取的接口。
  • board_name 保留画板名称，author_username 标识 Pin 关联作者，不直接等同于画板所有者。媒体与来源链接按条目实际返回保存，缺失时不生成；有画板 ID 不意味着能读取私密画板。

按 Pinterest 画板链接核对收藏容器信息

用 board_detail 获取画板元数据，Pin 列表另走 board_pins。

查看 board_detail 的 url 参数 →
  • url 使用 /用户名/画板名/ 的画板地址，也接受该相对路径；不是 /pin/数字ID/。返回 id、name、description 与 owner_username 对应画板及所有者，cover_image_url 只是封面图。
  • pin_count / section_count 只是数量，不包含 Pin 或分区明细；需要 Pin 内容时将返回 id 传给 board_pins。privacy 与 is_collaborative 不是授权凭据，私密画板的官方可见范围仍受所有者及邀请关系约束。

Pinterest API 常见问题

Pinterest API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="pinterest"、action 和 params。以 search 为例，必填 keyword，可选 content_type。这里填写灵感主题词；结果类型由 content_type 选择，画板与账号资料不能混作同一对象。 Pinterest 共 7 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Pinterest API 怎么收费？

$1.39 / 千次，Pinterest 全部 7 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 719 次 Pinterest 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

Pinterest API 一次能返回多少条数据？

Pinterest 有 4 个列表接口，包括 search、user_posts、boards、board_pins。其余 3 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

Pinterest API 返回哪些字段？

当前目录为 search 列出 id、url、title、text、image_url、reaction_count 等 14 个字段名。按全站当前目录统计，12 个字段名只在 Pinterest 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「按视觉主题检索 Pinterest Pin，并识别搜索类型边界」怎样接入 Pinterest API？

用 search 找到 Pin，再按 Pin 链接继续核对详情。 keyword 是主题词；content_type=all_pins_visual_posts 表示不限媒体形态的 Pin 搜索，不代表全量结果，videos_video_pins 表示视频 Pin 筛选。搜索只整理 Pin 字段，image_url 是图片地址，source_domain 是来源域名，不是视频播放地址。 画板集合和创作者主页已从 search 的公开取值中移除，因为当前结果处理只保留 Pin 对象。已知用户名时请分别使用 boards / profile；视频筛选效果也尚未逐项用付费真实调用验证。

「按 Pinterest 用户短名核对主页资料」怎样接入 Pinterest API？

用 profile 区分账号资料、Pin 数量和画板数量。 username 填主页中的用户短名，可带开头的 @，不填完整主页链接；返回 user_id 是账号标识，username / name 分别是用户名与显示名称。 pin_count、board_count、video_count 分别表示 Pin、画板和视频数量，follower_count 不是粉丝名单。is_verified 可能来自商家或身份验证信号，缺失不补 false；is_private 也不赋予读取私密内容的权限。

「整理 Pinterest 用户的 Pin 与外部来源」怎样接入 Pinterest API？

用 user_posts 建立账号相关 Pin 索引，不把收藏条目全部当作原创作品。 username 指定用户短名；返回 id / url 定位 Pin，author_username 与 board_name 保留作者及画板线索。Pin 可以来自保存的站外内容，账号关联不证明该账号持有全部内容版权。 image_url、video_url、media_type 按实际返回记录；external_link 是 Pin 指向的站外页面，source_domain 是来源域名。repin_count、reaction_count 与 comment_count 不是同一种互动，也不能相加后当作独立用户数。

「读取单条 Pinterest Pin 的媒体和落地链接」怎样接入 Pinterest API？

用 pin 核对一条视觉书签，不把商品 Pin 当成成交记录。 url 使用含 /pin/数字ID/ 的具体 Pin 链接，不是 /用户名/画板名/ 的画板地址，也不承诺解析任意短链接；当前公开必填项是 url，不能只提交 Pin 数字 ID。 external_link 与 source_domain 用于追溯站外来源，image_url / video_url 是各自媒体链接。price 如有返回是 Pin 携带的价格信息，可能缺失，不是已成交价格或库存保证；是否可以买到仍需核对零售商页面。

可以先免费试用 Pinterest API 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 Pinterest 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 7 个能力。无需信用卡。

更多社交内容 API

Behance APIB站 APIBluesky APIDailymotion APIDeviantArt APIDiscord API豆瓣 API抖音 API全部 89 平台 ↗

开始调用 Pinterest API

加微信领 $1 免费额度，先选一个 Pinterest 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始