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

- **URL**: https://apify.com/scrapepilotapi/pinterest-search-scraper.md
- **Developed by:** [ScrapePilot](https://apify.com/scrapepilotapi) (community)
- **Categories:** Automation, Lead generation, Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.99 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

## 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

### Input (Terminal / Env Compatible)

The actor input mirrors the `pin.py` terminal-style input:

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `query` | string | `"wallpaper"` | Search query or keyword (required) |
| `filter` | `"all"` \| `"videos"` | `"videos"` | Content filter: all pins or videos only |
| `limit` | integer (1–10000) | `100` | Maximum number of pins to extract |

**Example input (JSON):**
```json
{
  "query": "wallpaper",
  "filter": "videos",
  "limit": 100
}
````

For local/terminal runs, you can pass input via the `INPUT` environment variable (JSON string), same as `pin.py`.

### What does Pinterest Search Scraper do? 🤔

A Pinterest Search Scraper is a powerful tool that allows you to extract search results, images, pins, boards, and profile data directly from Pinterest. Instead of manually browsing Pinterest, this scraper automates the process, saving you time and effort. Whether you’re a digital marketer, researcher, or content creator, a scraper helps you gather data for trend analysis, competitor insights, or inspiration.

With tools like Apify Pinterest Scraper, Pinterest Scraper Python scripts, or even a Pinterest scraper GitHub project, you can pull structured data in bulk. This improves efficiency and opens doors to SEO research, influencer marketing, e-commerce insights, and product discovery.

👉 If you’ve been searching for a Pinterest Search Scraper free or a Pinterest Search Scraper online tool, you’re in the right place!

### 🛠️ 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? 📊

Here’s a quick overview of the data types you can extract with a Pinterest Search Scraper app:

| Data Type | Description |
| --- | --- |
| 🖼️ Images | Download pin images using a Pinterest Image Scraper. |
| 📝 Pin Titles | Extract SEO-rich pin titles for trend research. |
| 🔗 Pin URLs | Collect direct links to pins for traffic analysis. |
| 📌 Boards | Get board titles, descriptions, and related pins. |
| 👤 User Profiles | Scrape profile info like username, bio, followers, and following count. |
| 📧 Emails | Use a Pinterest Email Scraper to find potential influencer outreach targets. |
| 🏷️ Hashtags/Tags | Extract tags and hashtags for keyword optimization. |
| 📈 Engagement Data | Gather likes, comments, and repins for performance tracking. |

This makes it ideal for marketers, researchers, and developers who want structured Pinterest data.

### Key Features of Pinterest Search Scraper ⚡

Using a Pinterest Search Scraper APK or online tool comes with a wide range of benefits:

- 🔍 Advanced Search Extraction – Extract pins from specific keywords, hashtags, or categories.

- 🖼️ Pinterest Image Scraper – Automatically download high-quality images in bulk.

- ⚙️ Customizable Options – Works with Pinterest Scraper Python scripts, APIs, or apps.

- 📂 Multiple Formats – Export results in CSV, JSON, or Excel.

- 🔗 Pinterest API Support – Some scrapers integrate with the Pinterest API for advanced workflows.

- 🖥️ Cross-Platform – Use a Pinterest Search Scraper online, download a desktop version, or run on cloud platforms like Apify Pinterest.

- 🚀 Scalable – Scrape thousands of pins at once without manual effort.

- 💻 Developer Friendly – Available on Pinterest Scraper GitHub repositories for customization.

- 🔒 Safe & Secure – Ensures compliance when scraping publicly available data.

These features make it the best solution for businesses, researchers, and e-commerce sellers.

### 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 app has endless possibilities across industries:

- 📈 SEO & Keyword Research – Extract trending hashtags, tags, and pin titles for better rankings.

- 🛍️ E-commerce Sellers – Find product images, competitor boards, and buyer interests.

- 🤝 Influencer Marketing – Use a Pinterest Email Scraper to discover and connect with influencers.

- 📰 Content Creators – Gather inspiration for blogs, social media, and YouTube content.

- 🎨 Designers & Brands – Collect style boards and design trends for creative projects.

- 📊 Market Research – Analyze engagement data (likes, comments, repins) for insights.

From bloggers to businesses, everyone can benefit from a Pinterest Search Scraper download or online tool.

### Why choose us? 💡

Here’s why our Pinterest Search Scraper APK / app / online tool stands out:

- ✅ Easy to Use – No coding required.

- ⚡ Fast & Scalable – Extract thousands of pins in minutes.

- 🔄 Flexible – Works with Apify Pinterest, Axiom Web Scraper, or custom scripts.

- 🔐 Safe – Scrapes only public data, keeping you compliant.

- 🛠️ Developer Friendly – Open-source options available on Pinterest Scraper GitHub.

- 🌍 Global Support – Works across all countries and Pinterest regions.

Whether you need a Pinterest Search Scraper online or an advanced Pinterest Scraper Python script, we’ve got you covered.

### How many results can you scrape with “Pinterest Search Scraper”? 📊

One of the biggest strengths of the Pinterest Search Scraper free and paid versions is scalability. Unlike manual searching, this tool can extract hundreds or even thousands of results in bulk.

- A single run can scrape:

- 🔹 Pins – Unlimited keyword-based pins.

- 🔹 Boards – Multiple boards and their related pins.

- 🔹 Images – High-resolution images using the Pinterest Image Scraper.

- 🔹 User Data – Profiles, bios, followers, and links.

Using cloud-based scrapers like Apify Pinterest ensures that your scraping tasks run 24/7, without slowing down your system. If you’re a developer, you can integrate with the Pinterest API or customize your workflow with a Pinterest Scraper Python script.

👉 Whether you want 10 results or 10,000, a Pinterest Search Scraper online or app is built for speed, reliability, and performance.

### Is it legal to scrape Pinterest? ⚖️

Scraping Pinterest search results is generally legal as long as you’re extracting publicly available data and not violating Pinterest’s terms of service.

- ✅ Allowed: Collecting public pins, boards, and search results for research, marketing, or analysis.

- ❌ Not Allowed: Scraping private accounts, bypassing restrictions, or misusing scraped data.

To stay safe:

- Always comply with Pinterest API policies if you’re using official integrations.

- Use scraping tools responsibly and ethically.

- Avoid spamming or reselling scraped content.

👉 If you’re unsure, consult Pinterest’s official documentation or seek legal advice before large-scale scraping.

### Input Parameters 📝

Here’s an example input in JSON format:

```json
{
    "query": "laundry room ideas",
    "filter": "videos",
    "limit": 100,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
}
```

### 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 use Pinterest Search Scraper online tools like Apify’s free tier.

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

Absolutely! Many open-source projects are available, especially for Pinterest Scraper Python users.

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

You can register on Pinterest Developer Portal to get a Pinterest API key.

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

Yes, there are Pinterest Search Scraper APK downloads for mobile and desktop apps.

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

Yes, simply use a Pinterest Image Scraper mode to extract pictures only.

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

Yes! The Apify Pinterest Actor can scrape thousands of results automatically.

#### Q7: Can I combine Pinterest scraping with Axiom Web Scraper?

Yes, Axiom Web Scraper can be integrated with Pinterest scraping for automation.

# 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`):

Optional proxy configuration to improve stability and avoid Pinterest blocking.

## Actor input object example

```json
{
  "query": "wallpaper",
  "filter": "videos",
  "limit": 10
}
```

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapepilotapi/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 = {}

# Run the Actor and wait for it to finish
run = client.actor("scrapepilotapi/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 '{}' |
apify call scrapepilotapi/pinterest-search-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Pinterest Search Scraper",
        "version": "1.1",
        "x-build-id": "xabclE3ojce0FeBDp"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapepilotapi~pinterest-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapepilotapi-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/scrapepilotapi~pinterest-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-scrapepilotapi-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/scrapepilotapi~pinterest-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-scrapepilotapi-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": "Optional proxy configuration to improve stability and avoid Pinterest blocking."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
