# Pinterest Lens Api (`devcake/pinterest-lens-scraper`) Actor

Pinterest reverse image search and visual search tool. Search Pinterest by image to find similar images, products, Pins, source links, and prices.

- **URL**: https://apify.com/devcake/pinterest-lens-scraper.md
- **Developed by:** [devcake](https://apify.com/devcake) (community)
- **Categories:**
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.50 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Pinterest Reverse Image Search

Find visually similar Pinterest Pins from any picture. Upload an image or paste an image link, start the search, and get matching Pins with their images, titles, source websites, engagement, and available prices.

No Pinterest app or manual searching is required.

### ✨ What can you do with this Actor?

- 🔍 **Search Pinterest with a picture** instead of keywords.
- 🖼️ **Find visually similar Pins** for products, interiors, fashion, art, recipes, and inspiration.
- 🛍️ **Discover related products** and visit the websites linked from matching Pins.
- 📌 **Collect useful Pin details** such as the image, title, description, link, popularity, and price.
- 📚 **Search many images together** by adding up to 100 image links in one run.

### 🚀 How does it work?

1. **Add your picture** — paste a public image link or upload an image from your device.
2. **Choose how many matches you want** — the default is 24 Pins per picture.
3. **Click Start.**
4. **Explore your results** in an image-first table or download them for later use.

You can leave the sample image unchanged to test the Actor immediately. If you upload your own picture, the sample is ignored automatically.

### 🎯 Popular use cases

#### 🛋️ Find similar products by image

Upload a photo of furniture, clothing, decor, jewelry, or another product to discover visually related Pins. When available, results include the linked shop or website, product page, price, and currency.

#### 🎨 Build mood boards and find inspiration

Start with one reference image and discover similar colors, styles, layouts, and visual ideas on Pinterest. This is useful for design research, creative planning, trend discovery, and mood-board building.

#### 🛍️ Research products and competitors

See which visually similar products appear on Pinterest, where their Pins link, and how much engagement they have. Use the results as discovery signals for product and market research.

#### 📷 Search Pinterest by image URL or upload

Use a public image link when the picture is already online, or upload a JPEG, PNG, WebP, or GIF from your device. Each uploaded image can be up to 20 MB.

#### 📚 Search multiple pictures at once

Add up to 100 image links in one run. Every result stays connected to the picture that produced it, making it easy to compare matches across a larger collection.

### 📦 What information will you receive?

Each matching Pin is saved as a separate result. Depending on what Pinterest provides, a result can contain:

- the picture you searched with;
- the match position;
- the Pinterest Pin ID and link;
- the matching Pin image;
- the Pin title and description;
- the linked website and product page;
- repin and comment counts;
- the Pin creation date;
- whether the result is a video;
- the product price and currency.

Some details may be absent when Pinterest does not provide them for a particular Pin.

### 🧾 Example output in JSON

Every matching Pin produces one JSON object like this:

```json
{
  "inputUrl": "https://example.com/reference-chair.jpg",
  "imageFilename": "reference-chair.jpg",
  "position": 1,
  "pinId": "123456789012345678",
  "pinUrl": "https://www.pinterest.com/pin/123456789012345678/",
  "title": "Blue reading chair",
  "description": "Modern upholstered reading chair",
  "sourceDomain": "shop.example",
  "outboundUrl": "https://shop.example/chair",
  "imageUrl": "https://i.pinimg.com/1200x/example.jpg",
  "repinCount": 42,
  "commentCount": 3,
  "createdAt": "2025-01-15T12:30:00Z",
  "isVideo": false,
  "priceValue": 149.99,
  "priceCurrency": "USD"
}
```

### 👥 Who is this for?

- 🛒 **Online sellers and product researchers** looking for similar products and linked stores.
- 🎨 **Designers and creative teams** gathering visual inspiration.
- 📈 **Marketing and trend teams** studying popular visual styles on Pinterest.
- 🏷️ **Brands** reviewing how approved product photos or visual concepts appear in Pinterest results.
- 🔎 **Researchers** who want organized Pinterest matches without checking every result manually.

### 🔗 Related Actors

Continue your Pinterest and reverse-image research with our other Actors:

- 🔍 [**Pinterest Search Scraper**](https://apify.com/devcake/pinterest-search-scraper) — find Pins by keyword and collect their images, engagement, creator, board, and available product details.
- 📎 [**Pinterest Pin Scraper**](https://apify.com/devcake/pinterest-pin-scraping) — extract detailed Pin, product, merchant, price, engagement, and source data from Pinterest Pin links.
- 🌐 [**Google Lens Reverse Image Search**](https://apify.com/devcake/google-lens-scraper) — search beyond Pinterest for visual matches, exact copies, source pages, products, prices, and text found in images.

### ❓ Frequently asked questions

#### Can I search using a picture on Pinterest?

Yes. Paste a public image link or upload a picture, then start the Actor. It searches Pinterest Lens and returns visually similar Pins with their images, titles, Pin links, linked websites, and other available details.

#### Can I reverse image search multiple images at once?

Yes. You can add up to 100 public image links in one run and optionally add an uploaded image. Results identify the picture used for each search, so matches from different images do not get mixed together.

#### Can I find a product based on a picture?

The Actor can find visually related Pinterest Pins and show the websites, product pages, and prices connected to them when that information is available. A visual match can help with discovery, but it does not guarantee that two products are identical.

#### How many matching Pins will I receive?

The default is up to 24 Pins per picture. You can request up to 100, but Pinterest may return fewer matches depending on the image. The chosen number is a maximum rather than a guaranteed result count.

### ⚠️ Good to know

- Results come from Pinterest Lens, not from a web-wide image search.
- Visual similarity does not prove who owns an image or where it originally came from.
- Product details and prices appear only when Pinterest provides them.
- Use only images and Pinterest data you are allowed to process.

# Actor input Schema

## `imageUrls` (type: `array`):

Paste public JPEG, PNG, WebP, or GIF URLs. Repeated URLs are processed once. If you only upload a file, the sample URL is ignored.

## `imageFile` (type: `string`):

Upload one JPEG, PNG, WebP, or GIF up to 20 MB. Your own URLs above are also processed; only the unchanged sample URL is ignored.

## `maxResultsPerImage` (type: `integer`):

Save up to this many unique Pins per image. Pinterest commonly returns about 24 matches and may return fewer.

## Actor input object example

```json
{
  "imageUrls": [
    "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg"
  ],
  "maxResultsPerImage": 24
}
```

# Actor output Schema

## `pins` (type: `string`):

All normalized Pinterest Lens matches with source, content, engagement, media, and price fields.

## `overview` (type: `string`):

A compact image-first table with source, price, engagement, and rank.

## `summary` (type: `string`):

Per-image retries, terminal pagination state, result counts, and failures.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "imageUrls": [
        "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("devcake/pinterest-lens-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "imageUrls": ["https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg"] }

# Run the Actor and wait for it to finish
run = client.actor("devcake/pinterest-lens-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "imageUrls": [
    "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg"
  ]
}' |
apify call devcake/pinterest-lens-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,devcake/pinterest-lens-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/FiqszEwbXdpFfecjd/builds/mTKEA3PlbFHfmk6Oa/openapi.json