📷 Pinterest Lens & Reverse Image Search API Actor

The Pinterest Lens & Reverse Image Search Actor is an advanced web scraper and visual matching engine on the Apify platform. It enables seamless integration with Pinterest's visual search index, allowing you to search billions of images, discover visual duplicates, find similar products, and crawl rich pin metadata.

By passing either a public image URL or a base64 encoded image string, this Actor queries the target visual index and returns structured lists of matching Pins, shop links, pinner profiles, and website domains.

---

🌟 Key Features

• Instant Visual Search: Provide any image to immediately discover visually similar Pins and matching web assets across the web.
• Automatic Focal Coordinate Calculation: The Actor automatically analyzes the input image and calculates the optimal bounding box coordinates (internally mapping the search to normalized coordinates 0, 0, 1, 1 to target the entire image) so you don't need to specify manual cropping offsets.
• Base64 Payload Support: Directly submit base64-encoded strings (with or without MIME data headers), perfect for local application integrations where web-accessible URLs are not available.
• Destination Link Crawler: Automatically extracts the outbound URL/redirect link of each matched Pin, making it easy to identify product merchant sites.
• Structured Data Export: Download results in JSON, CSV, Excel, XML, or HTML formats via the Apify dataset store.

---

🛠️ Input Parameters

The Actor accepts the following input settings in JSON format:

Field	Type	Description
image_url	string	Public HTTP/HTTPS URL of the image to search.
image_base64	string	Base64 encoded string of the image (supporting prefix header format).

Note: One of image_url or image_base64 must be provided.

Input JSON Example

{
  "image_url": "https://images.unsplash.com/photo-1579546929518-9e396f3cc809?w=300"
}

---

📤 Output Structure

When the Actor executes, it stores the results directly in the default Dataset. Additionally, the raw JSON payload is saved under the OUTPUT key of the Key-Value Store.

Output Dataset Row Example

{
  "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"
}

---

🚀 Use Cases

• E-Commerce Visual Shopping: Seamlessly recommend matching inventory by letting users search using photos.
• Intellectual Property Protection: Scan Pinterest to verify if your designs or images are being used without authorization.
• Visual Social Listening: Track trends and viral designs across Pinterest boards.