Pinterest Data API

Scrape Pinterest data. Search pins, get pin details, user profiles, board info, and more — all returned as clean JSON.

原始信息汇总

Pinterest Data API 数据集概述

基本信息

• 数据集名称: Pinterest Data API
• 数据集类别: Social
• API提供平台: RapidAPI
• 提供者: elis-lab
• 当前版本: 1.0.0
• API基础地址: https://pinterest-data-api.p.rapidapi.com
• 数据格式: JSON

服务指标

• 受欢迎度: 9.1
• 服务等级: 86%
• 延迟: 1440ms

订阅计划与定价

• BASIC: $0.00 / 月
• PRO: $9.99 / 月
• ULTRA: $29.99 / 月
• MEGA: $69.99 / 月

功能描述

该API用于抓取Pinterest数据，无需身份验证。可搜索图钉、获取图钉详情、用户资料、画板信息等，所有数据均以干净的JSON格式返回。

端点列表

搜索类

• GET /search/pins: 按关键词搜索图钉
• GET /search/boards: 按关键词搜索画板
• GET /search/videos: 按关键词搜索视频图钉

详情获取类

• GET /pin/{id}: 获取单个图钉的完整详情
• GET /user/{username}: 获取用户公开资料
• GET /user/{username}/boards: 列出用户的所有公开画板
• GET /board: 获取特定画板的详细信息

关键参数与响应字段摘要

搜索图钉 (/search/pins)

• 必需参数: query (搜索关键词或短语)
• 可选参数: page_size (每页结果数，1–50，默认25), bookmark (分页游标)
• 响应字段:
  • results[]: 图钉对象数组，包含id、title、description、domain、link、dominant_color、created_at、save_count、comment_count、reaction_counts、images、pinner、board等
  • bookmark: 用于分页的游标

获取图钉详情 (/pin/{id})

• 必需参数: id (Pinterest图钉ID，路径参数)
• 额外字段 (相较于搜索端点): category、is_video、share_count、pinner.follower_count、board.pin_count、board.follower_count、images.170x

获取用户资料 (/user/{username})

• 必需参数: username (Pinterest用户名，路径参数)
• 响应字段: id、username、full_name、about、website_url、follower_count、following_count、pin_count、board_count、created_at、domain_verified、is_verified_merchant、is_private_profile、verified_identity、image_medium_url、image_xlarge_url

获取画板详情 (/board)

• 必需参数: username (画板所有者的用户名), slug (画板URL别名)
• 响应字段: id、name、description、url、pin_count、follower_count、collaborator_count、section_count、privacy、is_collaborative、created_at、image_cover_url、place_saves_count、owner

分页机制

• 支持分页的端点: /search/pins, /search/boards, /user/{username}/boards
• 机制: 响应中返回bookmark游标，将其传递到下一个请求中以获取下一页。
• 结束标志: 当bookmark为null时，表示已到达最后一页。
• 注意事项:
  • 始终使用最新响应中的bookmark，不要重复使用旧的游标。
  • 跨页面请求保持query和page_size参数不变。
  • page_size未指定时默认为25。

错误代码

• 200: 成功
• 404: 图钉/用户/画板未找到
• 422: 验证错误（参数缺失或无效）
• 502: Pinterest上游错误

使用提示

• 图钉ID获取: 从Pinterest URL中提取，例如 pinterest.com/pin/123456789/ 的ID是 123456789。
• 画板别名获取: 从Pinterest URL中提取，例如 pinterest.com/username/board-name/ 的别名是 board-name。
• 颜色匹配: 使用dominant_color字段构建颜色匹配的UI网格。
• 缩略图尺寸: 236x图像是Pinterest使用的标准网格缩略图尺寸。