# Pinterest Search Scraper (`scraper-engine/pinterest-search-scraper`) Actor

The Pinterest Search Scraper extracts data from Pinterest search results with ease. Collect pins, titles, descriptions, links, image URLs, and engagement stats. Ideal for marketers, researchers, and e-commerce owners to analyze trends, gather inspiration, or track competitors in bulk.

- **URL**: https://apify.com/scraper-engine/pinterest-search-scraper.md
- **Developed by:** [Scraper Engine](https://apify.com/scraper-engine) (community)
- **Categories:** Social media, Lead generation, Automation
- **Stats:** 52 total users, 1 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$14.99/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

### What does Pinterest Search Scraper do? 🤔

A Pinterest Search Scraper is a powerful pinterest scraping tool that lets you extract search results, images, pins, boards, and profile data directly from Pinterest. As an efficient Pinterest scraper, it automates pinterest scraping tasks, helping marketers, researchers, and creators collect valuable data without manual effort.

Built for scale, it supports bulk pinterest scraping and automated pinterest scraping, allowing you to gather large datasets for trend analysis, competitor insights, and content research. Using direct pinterest scraper tools, you can perform fast and structured bulk data extraction from search queries.

With solutions like Apify, Pinterest scraper Python, or Pinterest scraper GitHub projects, you can streamline workflows and improve efficiency.

👉 If you’re looking for a Pinterest Search Scraper free or an online solution, this tool simplifies data collection for SEO, e-commerce, and marketing insights.

### 🛠️ Support and Feedback

- 🐞 **Bug reports:** Open a ticket in the repository **Issues** section  
- ✨ **Custom solutions or feature requests:** Contact our team 📧 **Email:** dev.scraperengine@gmail.com

### What Pinterest Search Scraper” can I extract? 📊
A Pinterest Search Scraper is a powerful pinterest scraping tool built for structured pinterest scraping and scalable data collection. Using this Pinterest scraper, you can perform automated pinterest scraping and efficient bulk pinterest scraping to extract valuable insights from search results.

📁 Extractable Data Types

| Data Type | Description |
| --- | --- |
| 🖼️ Images | Download pin images using a Pinterest Image Scraper |
| 📝 Pin Titles | Extract SEO-rich titles for keyword and trend research |
| 🔗 Pin URLs | Collect direct links for traffic and analysis |
| 📌 Boards | Get board titles, descriptions, and related pins |
| 👤 User Profiles | Extract usernames, bios, and follower data |
| 📧 Emails | Use a Pinterest Email Scraper for outreach targeting |
| 🏷️ Hashtags/Tags | Capture tags for SEO and content optimization |
| 📈 Engagement Data | Gather likes, comments, and repins |

Using direct pinterest scraper tools, this setup enables reliable bulk data extraction for marketing, research, and automation workflows.

### Key Features of Pinterest Search Scraper ⚡

Using a **Pinterest Search Scraper** as a powerful **pinterest scraping tool** provides advanced capabilities for efficient **pinterest scraping**:

*   🔍 Advanced search extraction — Use a **Pinterest scraper** to pull data from keywords, hashtags, and categories.

*   🖼️ Image extraction — Supports **bulk pinterest scraping** to download high-quality pin images at scale.

*   ⚙️ Flexible setup — Works with **automated pinterest scraping** via Python scripts, APIs, or apps.

*   📂 Multiple export formats — Enables smooth **bulk data extraction** in CSV, JSON, or Excel.

*   🔗 API-ready workflows — Integrates with APIs and **direct pinterest scraper tools** for advanced pipelines.

*   🖥️ Cross-platform usage — Run on web, desktop, or cloud environments like Apify.

*   🚀 Scalable performance — Designed for large-scale **pinterest scraping** without manual effort.

*   💻 Developer-friendly — Compatible with GitHub projects and custom workflows.

*   🔒 Secure usage — Follows best practices for compliant **automated pinterest scraping**.

### How to use “Pinterest Search Scraper” 🛠️

Here’s a simple step-by-step guide to using a Pinterest Search Scraper free or online version:

1.  Log in to Apify – Create a free account or sign in.  
      
    
2.  Select the Actor – Search for “Pinterest Search Scraper” in the Apify store.  
      
    
3.  Enter Input Data – Paste your keywords, search queries, or Pinterest URLs.  
      
    
4.  Choose Options – Decide if you want images, pins, boards, or user data.  
      
    
5.  Run the Scraper – Hit start, and the scraper will fetch data automatically.  
      
    
6.  Download Results – Export results in JSON, CSV, or Excel.  
      
    

👉 You can also use a Pinterest Scraper GitHub project or run a Pinterest Scraper Python script locally if you prefer open-source tools.

### 🎯 Use Cases

A **Pinterest Search Scraper** is a versatile **pinterest scraping tool** that supports multiple real-world applications:

*   📈 SEO and Keyword Research — Use a **Pinterest scraper** for **pinterest scraping** to extract hashtags, tags, and pin titles for ranking insights.

*   🛍️ E-commerce Sellers — Leverage **bulk pinterest scraping** to discover product trends, competitor boards, and customer interests.

*   🤝 Influencer Marketing — Combine with tools like Pinterest Email Scraper for targeted outreach and lead generation.

*   📰 Content Creation — Use **automated pinterest scraping** to gather ideas for blogs, social media, and video content.

*   🎨 Design and Branding — Perform **bulk data extraction** to collect style boards and creative trends.

*   📊 Market Research — Analyze engagement metrics using **direct pinterest scraper tools** for deeper insights.

From individuals to enterprises, this solution simplifies scalable **pinterest scraping** for data-driven decisions.

### Why choose us? 💡

Our **Pinterest Search Scraper** is a reliable **pinterest scraping tool** built for performance, simplicity, and scale:

*   ✅ Easy to use — No coding required to run this powerful **Pinterest scraper**.

*   ⚡ Fast and scalable — Designed for **bulk pinterest scraping** and high-speed data collection.

*   🔄 Flexible workflows — Supports **automated pinterest scraping** with Apify, Axiom, or custom pipelines.

*   🔐 Safe and compliant — Ensures responsible **pinterest scraping** using only public data.

*   🛠️ Developer-friendly — Works with scripts and **direct pinterest scraper tools**, including GitHub projects.

*   🌍 Global coverage — Enables **bulk data extraction** across all Pinterest regions and markets.

Whether you need a simple tool or advanced automation, this solution makes **automated pinterest scraping** efficient and scalable.

### How many results can you scrape with “Pinterest Search Scraper”? 📊
A **Pinterest Search Scraper** is a scalable **pinterest scraping tool** designed for both small and large data needs. Using this **Pinterest scraper**, you can perform efficient **pinterest scraping** with support for **bulk pinterest scraping** and high-volume extraction.

📌 **Per Run Capabilities:**

*   🔹 Pins — Extract large volumes using keyword-based **automated pinterest scraping**.

*   🔹 Boards — Collect multiple boards and related data with structured **bulk data extraction**.

*   🔹 Images — Download high-quality visuals at scale using integrated scraping workflows.

*   🔹 User Data — Gather profiles, bios, and engagement metrics easily.

Cloud-based solutions and **direct pinterest scraper tools** enable continuous scraping without system slowdowns. Developers can also integrate APIs or scripts for advanced automation.

👉 Whether you need 10 or 10,000 results, this tool ensures fast, reliable, and scalable **pinterest scraping** performance.

### Is it legal to scrape Pinterest? ⚖️

Using a **Pinterest Search Scraper** or any **pinterest scraping tool** is generally acceptable when limited to ethical **pinterest scraping** of publicly available data. A responsible **Pinterest scraper** should always follow platform rules and legal guidelines.

✅ **Allowed:** Collecting public pins, boards, and search results using **automated pinterest scraping** for research, marketing, or analytics.

❌ **Not Allowed:** Accessing private accounts, bypassing restrictions, or misusing data from **bulk pinterest scraping**.

📌 **Best Practices:**  
✔️ Follow Pinterest API and platform policies  
✔️ Use **direct pinterest scraper tools** responsibly  
✔️ Avoid spam, abuse, or resale of scraped data  
✔️ Ensure compliance when performing **bulk data extraction**

👉 When in doubt, review official documentation or consult legal guidance before scaling **pinterest scraping** workflows.

### Input Parameters 📝

Here’s an example input in JSON format:
```json
{
    "keyword": "laundry room ideas",
    "proxy_configuration": {
        "useApifyProxy": false
    },
    "urls": [
        "laundry room ideas",
        "kitchen design"
    ]
}
````

### Output Format 📦

Example output in JSON format:

```json
[
  {
    "query": "laundry room ideas",
    "node_id": "140806234212431",
    "type": "pin",
    "title": "",
    "description": " ",
    "domain": "Uploaded by user",
    "link": "",
    "dominant_color": "#a09990",
    "created_at": "Tue, 15 Jul 2025 12:51:39 +0000",
    "board": {
      "node_id": "Qm9hcmQ6MTQwODc0OTI3MzczMjIy",
      "images": {
        "170x": [
          {
            "url": "https://i.pinimg.com/170x/57/5d/e1/575de1eed160baf017bc6bd84ae6e1e8.jpg",
            "width": 170,
            "height": 302,
            "dominant_color": "#A09990"
          },
          {
            "url": "https://i.pinimg.com/170x/14/6e/45/146e45d2828c5e6541f172c189f0b391.jpg",
            "width": 170,
            "height": 194,
            "dominant_color": "#959B8D"
          },
          {
            "url": "https://i.pinimg.com/170x/a2/05/6b/a2056b1ed0025d0d53899a2e498128e5.jpg",
            "width": 170,
            "height": 254,
            "dominant_color": "#847665"
          },
          {
            "url": "https://i.pinimg.com/170x/b5/13/a5/b513a5e9d164428acd437b54bb018eef.jpg",
            "width": 170,
            "height": 255,
            "dominant_color": "#E0D1CE"
          },
          {
            "url": "https://i.pinimg.com/170x/08/c8/c3/08c8c3705f1a630f6ac3649fc5f32c8a.jpg",
            "width": 170,
            "height": 170,
            "dominant_color": "#AA9B89"
          },
          {
            "url": "https://i.pinimg.com/170x/bd/ae/10/bdae10e2b76fd78ff038bf4104c9ee18.jpg",
            "width": 170,
            "height": 226,
            "dominant_color": "#C3BCB0"
          },
          {
            "url": "https://i.pinimg.com/170x/3c/d8/5b/3cd85b620eac1487e121746cbd64271f.jpg",
            "width": 170,
            "height": 226,
            "dominant_color": "#CFBBAA"
          },
          {
            "url": "https://i.pinimg.com/170x/42/02/2b/42022bd76dd7d1d345665fa5adf2a87e.jpg",
            "width": 170,
            "height": 226,
            "dominant_color": "#A6947B"
          },
          {
            "url": "https://i.pinimg.com/170x/e0/50/b6/e050b6ba3c14b91fd093ad5c9b4051be.jpg",
            "width": 170,
            "height": 255,
            "dominant_color": "#C0AE9C"
          },
          {
            "url": "https://i.pinimg.com/170x/61/57/53/61575357f4aa9836b58395a074a5ffcc.jpg",
            "width": 170,
            "height": 301,
            "dominant_color": "#B0A895"
          },
          {
            "url": "https://i.pinimg.com/170x/eb/6c/42/eb6c42f20ec310a84fc35327ba8e272c.jpg",
            "width": 170,
            "height": 306,
            "dominant_color": "#5E584A"
          },
          {
            "url": "https://i.pinimg.com/170x/9d/44/2f/9d442f85d537b7fdc6ab4e0a0437e80b.jpg",
            "width": 170,
            "height": 226,
            "dominant_color": "#968D7E"
          },
          {
            "url": "https://i.pinimg.com/170x/91/cf/e6/91cfe60c24e2c76d2ec68c4f9f12faed.jpg",
            "width": 170,
            "height": 226,
            "dominant_color": "#85877C"
          },
          {
            "url": "https://i.pinimg.com/170x/c8/25/04/c82504dea157d9918189987a174f0384.jpg",
            "width": 170,
            "height": 212,
            "dominant_color": "#7B6C55"
          },
          {
            "url": "https://i.pinimg.com/170x/85/a6/7e/85a67e31e26182e654908f48667bb99e.jpg",
            "width": 170,
            "height": 302,
            "dominant_color": "#B9B9AF"
          }
        ]
      },
      "cover_images": {
        "222x": {
          "url": "https://i.pinimg.com/222x/43/3e/8a/433e8a82c35c8e02df0f67a1100c2780.jpg",
          "width": 222
        }
      },
      "image_cover_url": "https://i.pinimg.com/200x150/43/3e/8a/433e8a82c35c8e02df0f67a1100c2780.jpg",
      "collaborating_users": [],
      "section_count": 7,
      "collaborator_count": 0,
      "board_order_modified_at": "Thu, 21 Aug 2025 14:55:15 +0000",
      "id": "140874927373222",
      "image_cover_hd_url": "https://i.pinimg.com/474x/43/3e/8a/433e8a82c35c8e02df0f67a1100c2780.jpg",
      "is_collaborative": false,
      "pin_count": 142,
      "type": "board",
      "url": "/ellysebull/dream-house/",
      "name": "Dream house",
      "owner": {
        "node_id": "VXNlcjoxNDA5NDM2NDY3ODgzMjI=",
        "image_medium_url": "https://i.pinimg.com/75x75_RS/51/96/3b/51963bc04975ce28f94095120c319c8d.jpg",
        "image_large_url": "https://i.pinimg.com/140x140_RS/51/96/3b/51963bc04975ce28f94095120c319c8d.jpg",
        "is_ads_only_profile": false,
        "id": "140943646788322",
        "full_name": "Ellyse Bull",
        "verified_identity": {},
        "is_verified_merchant": false,
        "follower_count": 101,
        "image_small_url": "https://i.pinimg.com/30x30_RS/51/96/3b/51963bc04975ce28f94095120c319c8d.jpg",
        "username": "ellysebull"
      }
    },
    "reaction_counts": {
      "1": 460
    },
    "native_creator": {},
    "pinner": {
      "node_id": "VXNlcjoxNDA5NDM2NDY3ODgzMjI=",
      "image_medium_url": "https://i.pinimg.com/75x75_RS/51/96/3b/51963bc04975ce28f94095120c319c8d.jpg",
      "image_large_url": "https://i.pinimg.com/140x140_RS/51/96/3b/51963bc04975ce28f94095120c319c8d.jpg",
      "is_ads_only_profile": false,
      "id": "140943646788322",
      "full_name": "Ellyse Bull",
      "verified_identity": {},
      "is_verified_merchant": false,
      "follower_count": 101,
      "image_small_url": "https://i.pinimg.com/30x30_RS/51/96/3b/51963bc04975ce28f94095120c319c8d.jpg",
      "username": "ellysebull"
    },
    "image_url": "https://i.pinimg.com/originals/57/5d/e1/575de1eed160baf017bc6bd84ae6e1e8.jpg",
    "image_width": 1024,
    "image_height": 1820
  }, ......
]
```

### 🔗 What are other Pinterest scraping tools?

If you want to scrape specific Pinterest data, you can use any of the dedicated scrapers below for faster and more targeted results.\
Just enter profile URLs, board links, keywords, search queries, or pin URLs and start scraping instantly.

| [⌨️ Pinterest Autocomplete Scraper](https://apify.com/scraper-engine/pinterest-autocomplete-scraper) | [👥 Pinterest Followers Scraper](https://apify.com/scraper-engine/pinterest-followers-scraper) |
|---|---|
| [📌 Pinterest Pins/Videos Search Scraper](https://apify.com/scraper-engine/pinterest-pins-videos-search-scraper) | [📞 Pinterest Phone Number Scraper](https://apify.com/scraper-engine/pinterest-phone-number-scraper) |
| [📧 Pinterest Email Scraper](https://apify.com/scraper-engine/pinterest-email-scraper) | [🔁 Pinterest Following Scraper](https://apify.com/scraper-engine/pinterest-following-scraper) |
| [📂 Pinterest Boards Scraper](https://apify.com/scraper-engine/pinterest-boards-scraper) | [👤 Pinterest Profile Scraper](https://apify.com/scraper-engine/pinterest-profile-scraper) |
| [🔑 Pinterest Keywords Discovery](https://apify.com/scraper-engine/pinterest-keywords-discovery) |

### ❓ FAQ

#### Q1: Is there a Pinterest Search Scraper free version?

 👉 Yes, you can start with a free tier using this pinterest scraping tool and scale as needed.

#### Q2: Can I use a Pinterest Scraper GitHub project?

 ✅ Absolutely. Many developers use GitHub projects with automated pinterest scraping and custom workflows.

#### Q3: How do I get a Pinterest API key?

 🔑 Register on the developer portal and integrate it with your Pinterest scraper or direct pinterest scraper tools.

#### Q4: Can I download a Pinterest Search Scraper app or APK?

 📱 Yes, but most modern pinterest scraping tools run in the cloud for better performance.

#### Q5: Is it possible to scrape Pinterest images only?

 🖼️ Yes, you can perform targeted pinterest scraping for images using specialized modes.

#### Q6: Does Apify Pinterest support bulk scraping?

 🚀 Yes, it supports bulk pinterest scraping and efficient bulk data extraction at scale.

#### Q7: Can I combine Pinterest scraping with automation tools?

 ⚙️ Yes, integrations enable automated pinterest scraping workflows for continuous data pipelines.

### 🏁 Conclusion

A Pinterest Search Scraper is a powerful pinterest scraping tool designed to simplify large-scale data collection. Whether you need bulk pinterest scraping or automated pinterest scraping, it helps you extract valuable insights from pins, boards, and search results efficiently. As a reliable Pinterest scraper, it enables clean bulk data extraction for SEO, research, and marketing workflows.

With scalable direct pinterest scraper tools, you can turn raw Pinterest data into actionable insights and stay ahead in data-driven decision-making.

# Actor input Schema

## `query` (type: `string`):

What to search for on Pinterest (e.g. wallpaper, recipes, DIY ideas)

## `filter` (type: `string`):

Show all pins or only video pins

## `limit` (type: `integer`):

How many pins you want (1–10,000)

## `proxyConfiguration` (type: `object`):

Apify Residential proxy is strongly recommended — Pinterest blocks datacenter IPs and the run will return zero pins without a residential session.

## Actor input object example

```json
{
  "query": "wallpaper",
  "filter": "videos",
  "limit": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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 = {
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scraper-engine/pinterest-search-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 = { "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    } }

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

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

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

```

## CLI example

```bash
echo '{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call scraper-engine/pinterest-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scraper-engine/pinterest-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Pinterest Search Scraper",
        "description": "The Pinterest Search Scraper extracts data from Pinterest search results with ease. Collect pins, titles, descriptions, links, image URLs, and engagement stats. Ideal for marketers, researchers, and e-commerce owners to analyze trends, gather inspiration, or track competitors in bulk.",
        "version": "1.0",
        "x-build-id": "cwmz3byQKMK2qwgjp"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scraper-engine~pinterest-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scraper-engine-pinterest-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/scraper-engine~pinterest-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-scraper-engine-pinterest-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/scraper-engine~pinterest-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-scraper-engine-pinterest-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "query"
                ],
                "properties": {
                    "query": {
                        "title": "🔎 Search Query",
                        "type": "string",
                        "description": "What to search for on Pinterest (e.g. wallpaper, recipes, DIY ideas)",
                        "default": "wallpaper"
                    },
                    "filter": {
                        "title": "📌 Content Type",
                        "enum": [
                            "all",
                            "videos"
                        ],
                        "type": "string",
                        "description": "Show all pins or only video pins",
                        "default": "videos"
                    },
                    "limit": {
                        "title": "📊 Number of Pins",
                        "minimum": 1,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "How many pins you want (1–10,000)",
                        "default": 10
                    },
                    "proxyConfiguration": {
                        "title": "🌐 Proxy Configuration",
                        "type": "object",
                        "description": "Apify Residential proxy is strongly recommended — Pinterest blocks datacenter IPs and the run will return zero pins without a residential session.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
