Pinterest Lens & Reverse Image Search API

The **Pinterest Lens API** acts as a unified developer gateway for reverse image search and visual match discovery on Pinterest. Send any image (via URL or base64 stream) to find visually similar items, Pins, associated product links, pinner profiles, and matching websites directly from Pinterest's visual index.

原始信息汇总

Pinterest Lens & Reverse Image Search API 总结

API 概述

• 名称: Pinterest Lens & Reverse Image Search API
• 版本: 1.0.0 (current)
• 提供商: dev00
• 分类: Search
• 流行度: 8.2
• 服务等级: 100%
• 延迟: 468ms
• 测试通过率: 100%
• 订阅计划: BASIC ($0.00/月), PRO ($19.99/月), ULTRA ($49.99/月), MEGA ($149.99/月)

核心功能

该API是一个生产就绪的高性能视觉搜索网关，利用Pinterest的视觉发现引擎。开发者通过传递图片URL或base64编码的图片字符串，即可搜索数十亿索引图片和Pin，实时获取视觉匹配内容、关联网站域名、电商产品链接及Pinner归属详情。

关键用例

1. 视觉电商与Shop-the-Look集成: 允许用户上传服装、家具、家居装饰等照片，立即发现匹配的购买链接和类似产品。
2. 版权与数字资产保护: 扫描网络和Pinterest视觉索引，定位专有照片、艺术作品、设计等的被Pin或被分享位置，便于版权追踪与执行。
3. SEO、趋势分析与社交聆听: 监控流行视觉趋势，追踪热门图片、关联Board、Pin和标签。
4. 图片增强与自动标签: 通过API查询提取描述性标题、说明和标签，增强数据库元数据。

高级特性与设计

• 零配置坐标引擎: 自动分析图片并计算最佳裁剪聚焦坐标，再查询Pinterest视觉索引。
• 双重上传支持: 支持公共HTTP/HTTPS URL或base64编码图片流（可带数据URL头）。
• 出站目标链接: 提取并解析每个视觉匹配的最终目标网址，便于重定向至原始商家页面。
• 边缘原生架构: 基于Cloudflare Workers运行，最小化往返时间，防止服务器过载。

API 参考

• 端点: POST /search
  • 请求格式: application/json
  • 请求体参数:
    • image_url (字符串，可选): 图片的公开URL，必须以 http:// 或 https:// 开头。
    • image_base64 (字符串，可选): 目标图片文件的base64编码表示，接受原始base64或带前缀格式（如 data:image/jpeg;base64,...）。
  • 注意: image_url 和 image_base64 必须提供其一。
• 端点: GET /health（返回网关状态与健康检查）

示例成功响应 (JSON)

json { "status": "success", "code": 0, "message": "ok", "endpoint_name": "v3_extension_image_handler", "data": [ { "domain": "creativemarket.com", "is_repin": false, "created_at": "Fri, 06 Dec 2024 20:36:02 +0000", "type": "pin", "id": "112730796954872157", "image_medium_url": "https://i.pinimg.com/400x/a4/39/71/a43971425c73c0f9ce138c7c74419af4.jpg", "link": "https://creativemarket.com/product/91166409-Abstract-moving-neon-orange-light-green-yellow-blue-bright-pink-purple-gradient-background", "description": "Abstract moving neon orange light green yellow blue bright pink purple gradient background...", "title": "Abstract Neon Fluid Animation" } ] }

关键词与搜索词

pinterest lens api, reverse image search, visual search api, search by image pinterest, image recognition api, similar images lookup, shop by image, pinterest image scraper, pinterest matches finder, visual shopping api