# Pinterest Scraper by search query, detailed output (`dt_org/pinterest-scraper-by-search-query-detailed-output`) Actor

Scrape Pinterest pins detailed information(boards, users etc) from search results by queries. Extract images, videos, pinner data, pin onwer data, SEO metadata and many other fields. 40+ data fields per scraped pin with multi-resolution images.

- **URL**: https://apify.com/dt\_org/pinterest-scraper-by-search-query-detailed-output.md
- **Developed by:** [DreamTeam](https://apify.com/dt_org) (community)
- **Categories:** Developer tools, E-commerce, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 query results counts

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

### What is Pinterest Scraper?

📌 **Pinterest Scraper** is a fast, reliable tool that extracts pins, boards, and pinner data from Pinterest search results. Just **enter your search queries and click "Save & Start"** — no login, no API keys, no rate-limit headaches.

Use it to build image datasets, monitor trends, research boards, or feed content pipelines with fresh Pinterest data.

### What Pinterest data can I extract?

With this scraper, you'll get the following data for every pin:

| | |
|---|---|
| 🖼 Best available image URL + all resolutions | 🎬 Video URL, thumbnail and duration (for video pins) |
| 📝 Title, description and alt text | 🎨 Dominant color (hex) |
| 🔗 Direct pin URL | 🌐 External link (e.g. source website, Instagram, etc.) |
| ❤️ Reaction count | 🗓 Creation date |
| 👤 Pinner username, name, followers, profile link | 📋 Board name, URL, pin count, cover images |
| 👑 Board owner username, name, followers | ✨ Story Pin (Idea Pin) title and page count |

### Why scrape Pinterest?

🎨 Build image/style datasets for design or ML projects

📈 Track visual trends by niche or keyword

🕵️ Research competitor boards and content strategy

🛍 Discover product and aesthetic inspiration at scale

🤖 Feed content pipelines, mood boards, or recommendation engines

### How do I use Pinterest Scraper?

Pinterest Scraper was designed to be easy to start with, even if you've never scraped data from the web before:

1. [Create](https://console.apify.com/sign-up) a free Apify account using your email.
2. Open **Pinterest Scraper**.
3. Add one or more **search queries** (e.g. `"cars"`, `"minimalist logo"`, `"girls"`).
4. Set how many results you want per query.
5. Click "Start" and wait for the data to be extracted.
6. Download your data in JSON, CSV, Excel, HTML, or XML.

### Input

The input for Pinterest Scraper is a list of **search queries** plus how many results you want per query:

```json
{
  "queries": ["cars", "funny animals", "girls"],
  "resultsPerQuery": 20
}
````

> ℹ️ **Note:** `resultsPerQuery` is a target, not a hard limit. Pinterest returns results in fixed-size pages, so the actual count per query may land slightly above or below what you set (e.g. requesting 20 may return 18-25).

````

### Output sample

Every item in the dataset looks like this:

```json
{
    "query": "funny animals",
    "id": "774124930263517",
    "pin_url": "https://pinterest.com/pin/774124930263517/",
    "title": "",
    "description": "This is a dedicated page for dogs being dogs posting content everyday. Follow @dogdingda_official for more 👍 #funnydog #dog #dogsofinstagram #dogs #funnydogs #dogstagram #puppy #cutedog #doglife #doglover #funny #instadog #dogoftheday #doggo #doglovers #happydog #cute #love #puppylove #funnyvideos #cutedogs #funnydogvideos #dogvideos #pets #ilovemydog #dogsofinsta #meme #pet #dogmeme #puppiesofinstagram",
    "created_at": "Fri, 29 Nov 2024 02:45:50 +0000",
    "dominant_color": "#ad7564",
    "seo_alt_text": "a white dog holding a flower in its mouth and smiling at the camera with a sunset behind it",
    "auto_alt_text": "a white dog holding a flower in its mouth and smiling at the camera with a sunset behind it",
    "is_promoted": false,
    "is_oos_product": false,
    "reaction_counts": {
      "1": 3356,
      "5": 3
    },
    "image_best_url": "https://i.pinimg.com/736x/97/d1/09/97d10958071b399c8215629d7ea4fbc9.jpg",
    "image_best_width": 540,
    "image_best_height": 960,
    "image_resolutions": {
      "236x": "https://i.pinimg.com/236x/97/d1/09/97d10958071b399c8215629d7ea4fbc9.jpg",
      "474x": "https://i.pinimg.com/474x/97/d1/09/97d10958071b399c8215629d7ea4fbc9.jpg",
      "564x": "https://i.pinimg.com/564x/97/d1/09/97d10958071b399c8215629d7ea4fbc9.jpg",
      "736x": "https://i.pinimg.com/736x/97/d1/09/97d10958071b399c8215629d7ea4fbc9.jpg",
      "originals": "https://i.pinimg.com/originals/97/d1/09/97d10958071b399c8215629d7ea4fbc9.png"
    },
    "pinner_username": "gilletteen",
    "pinner_profile_url": "https://pinterest.com/gilletteen/",
    "pinner_full_name": "Elizabeth Gillette",
    "pinner_follower_count": 232,
    "board_id": "774193625355642",
    "board_name": "E animals",
    "board_url": "https://pinterest.com/gilletteen/e-animals/",
    "board_pin_count": 188,
    "board_is_collaborative": false,
    "board_images": [
      {
        "signature": "19ab69a0ae62d307b8924e6fbc906a9f",
        "dominant_color": "#716A62",
        "resolutions": {
          "236x": "https://i.pinimg.com/236x/19/ab/69/19ab69a0ae62d307b8924e6fbc906a9f.jpg",
          "474x": "https://i.pinimg.com/474x/19/ab/69/19ab69a0ae62d307b8924e6fbc906a9f.jpg",
          "564x": "https://i.pinimg.com/564x/19/ab/69/19ab69a0ae62d307b8924e6fbc906a9f.jpg",
          "736x": "https://i.pinimg.com/736x/19/ab/69/19ab69a0ae62d307b8924e6fbc906a9f.jpg",
          "originals": "https://i.pinimg.com/originals/19/ab/69/19ab69a0ae62d307b8924e6fbc906a9f.png"
        }
      },
      {
        "signature": "22ce645dde2a6d8df09e9aec2c0e2eaf",
        "dominant_color": "#7F6856",
        "resolutions": {
          "236x": "https://i.pinimg.com/236x/22/ce/64/22ce645dde2a6d8df09e9aec2c0e2eaf.jpg",
          "474x": "https://i.pinimg.com/474x/22/ce/64/22ce645dde2a6d8df09e9aec2c0e2eaf.jpg",
          "564x": "https://i.pinimg.com/564x/22/ce/64/22ce645dde2a6d8df09e9aec2c0e2eaf.jpg",
          "736x": "https://i.pinimg.com/736x/22/ce/64/22ce645dde2a6d8df09e9aec2c0e2eaf.jpg",
          "originals": "https://i.pinimg.com/originals/22/ce/64/22ce645dde2a6d8df09e9aec2c0e2eaf.png"
        }
      },
      {
        "signature": "492889a83fd13373146446895c39fc3d",
        "dominant_color": "#79684D",
        "resolutions": {
          "236x": "https://i.pinimg.com/236x/49/28/89/492889a83fd13373146446895c39fc3d.jpg",
          "474x": "https://i.pinimg.com/474x/49/28/89/492889a83fd13373146446895c39fc3d.jpg",
          "564x": "https://i.pinimg.com/564x/49/28/89/492889a83fd13373146446895c39fc3d.jpg",
          "736x": "https://i.pinimg.com/736x/49/28/89/492889a83fd13373146446895c39fc3d.jpg",
          "originals": "https://i.pinimg.com/originals/49/28/89/492889a83fd13373146446895c39fc3d.png"
        }
      },
      {
        "signature": "4ce46ea5eefdd4a26ba551b1279ed801",
        "dominant_color": "#DCB885",
        "resolutions": {
          "236x": "https://i.pinimg.com/236x/4c/e4/6e/4ce46ea5eefdd4a26ba551b1279ed801.jpg",
          "474x": "https://i.pinimg.com/474x/4c/e4/6e/4ce46ea5eefdd4a26ba551b1279ed801.jpg",
          "564x": "https://i.pinimg.com/564x/4c/e4/6e/4ce46ea5eefdd4a26ba551b1279ed801.jpg",
          "736x": "https://i.pinimg.com/736x/4c/e4/6e/4ce46ea5eefdd4a26ba551b1279ed801.jpg",
          "originals": "https://i.pinimg.com/originals/4c/e4/6e/4ce46ea5eefdd4a26ba551b1279ed801.png"
        }
      },
      {
        "signature": "ce8f629f44e7ea92dd81b1952b268861",
        "dominant_color": "#D7AB9A",
        "resolutions": {
          "236x": "https://i.pinimg.com/236x/ce/8f/62/ce8f629f44e7ea92dd81b1952b268861.jpg",
          "474x": "https://i.pinimg.com/474x/ce/8f/62/ce8f629f44e7ea92dd81b1952b268861.jpg",
          "564x": "https://i.pinimg.com/564x/ce/8f/62/ce8f629f44e7ea92dd81b1952b268861.jpg",
          "736x": "https://i.pinimg.com/736x/ce/8f/62/ce8f629f44e7ea92dd81b1952b268861.jpg",
          "originals": "https://i.pinimg.com/originals/ce/8f/62/ce8f629f44e7ea92dd81b1952b268861.png"
        }
      },
      {
        "signature": "5787cd152d6c5bfc888a0d2153ca375d",
        "dominant_color": "#716849",
        "resolutions": {
          "236x": "https://i.pinimg.com/236x/57/87/cd/5787cd152d6c5bfc888a0d2153ca375d.jpg",
          "474x": "https://i.pinimg.com/474x/57/87/cd/5787cd152d6c5bfc888a0d2153ca375d.jpg",
          "564x": "https://i.pinimg.com/564x/57/87/cd/5787cd152d6c5bfc888a0d2153ca375d.jpg",
          "736x": "https://i.pinimg.com/736x/57/87/cd/5787cd152d6c5bfc888a0d2153ca375d.jpg",
          "originals": "https://i.pinimg.com/originals/57/87/cd/5787cd152d6c5bfc888a0d2153ca375d.png"
        }
      },
      {
        "signature": "c5e94c4fae31127e19c851516c78bffb",
        "dominant_color": "#6E675A",
        "resolutions": {
          "236x": "https://i.pinimg.com/236x/c5/e9/4c/c5e94c4fae31127e19c851516c78bffb.jpg",
          "474x": "https://i.pinimg.com/474x/c5/e9/4c/c5e94c4fae31127e19c851516c78bffb.jpg",
          "564x": "https://i.pinimg.com/564x/c5/e9/4c/c5e94c4fae31127e19c851516c78bffb.jpg",
          "736x": "https://i.pinimg.com/736x/c5/e9/4c/c5e94c4fae31127e19c851516c78bffb.jpg",
          "originals": "https://i.pinimg.com/originals/c5/e9/4c/c5e94c4fae31127e19c851516c78bffb.png"
        }
      },
      {
        "signature": "9c10b1f048b3eab932d6ea6ed525636b",
        "dominant_color": "#BBADA8",
        "resolutions": {
          "236x": "https://i.pinimg.com/236x/9c/10/b1/9c10b1f048b3eab932d6ea6ed525636b.jpg",
          "474x": "https://i.pinimg.com/474x/9c/10/b1/9c10b1f048b3eab932d6ea6ed525636b.jpg",
          "564x": "https://i.pinimg.com/564x/9c/10/b1/9c10b1f048b3eab932d6ea6ed525636b.jpg",
          "736x": "https://i.pinimg.com/736x/9c/10/b1/9c10b1f048b3eab932d6ea6ed525636b.jpg",
          "originals": "https://i.pinimg.com/originals/9c/10/b1/9c10b1f048b3eab932d6ea6ed525636b.png"
        }
      },
      {
        "signature": "14f58814610927b7c120bdef563a0486",
        "dominant_color": "#9B8779",
        "resolutions": {
          "236x": "https://i.pinimg.com/236x/14/f5/88/14f58814610927b7c120bdef563a0486.jpg",
          "474x": "https://i.pinimg.com/474x/14/f5/88/14f58814610927b7c120bdef563a0486.jpg",
          "564x": "https://i.pinimg.com/564x/14/f5/88/14f58814610927b7c120bdef563a0486.jpg",
          "736x": "https://i.pinimg.com/736x/14/f5/88/14f58814610927b7c120bdef563a0486.jpg",
          "originals": "https://i.pinimg.com/originals/14/f5/88/14f58814610927b7c120bdef563a0486.png"
        }
      },
      {
        "signature": "f6d6c45d66eabf6385baf71adcff79ec",
        "dominant_color": "#737849",
        "resolutions": {
          "236x": "https://i.pinimg.com/236x/f6/d6/c4/f6d6c45d66eabf6385baf71adcff79ec.jpg",
          "474x": "https://i.pinimg.com/474x/f6/d6/c4/f6d6c45d66eabf6385baf71adcff79ec.jpg",
          "564x": "https://i.pinimg.com/564x/f6/d6/c4/f6d6c45d66eabf6385baf71adcff79ec.jpg",
          "736x": "https://i.pinimg.com/736x/f6/d6/c4/f6d6c45d66eabf6385baf71adcff79ec.jpg",
          "originals": "https://i.pinimg.com/originals/f6/d6/c4/f6d6c45d66eabf6385baf71adcff79ec.png"
        }
      },
      {
        "signature": "87048b3c8f35ecb349ad8fee24b52749",
        "dominant_color": "#9C9FA1",
        "resolutions": {
          "236x": "https://i.pinimg.com/236x/87/04/8b/87048b3c8f35ecb349ad8fee24b52749.jpg",
          "474x": "https://i.pinimg.com/474x/87/04/8b/87048b3c8f35ecb349ad8fee24b52749.jpg",
          "564x": "https://i.pinimg.com/564x/87/04/8b/87048b3c8f35ecb349ad8fee24b52749.jpg",
          "736x": "https://i.pinimg.com/736x/87/04/8b/87048b3c8f35ecb349ad8fee24b52749.jpg",
          "originals": "https://i.pinimg.com/originals/87/04/8b/87048b3c8f35ecb349ad8fee24b52749.png"
        }
      },
      {
        "signature": "e16df1c4548b483a6aa6551999ecda8f",
        "dominant_color": "#988277",
        "resolutions": {
          "236x": "https://i.pinimg.com/236x/e1/6d/f1/e16df1c4548b483a6aa6551999ecda8f.jpg",
          "474x": "https://i.pinimg.com/474x/e1/6d/f1/e16df1c4548b483a6aa6551999ecda8f.jpg",
          "564x": "https://i.pinimg.com/564x/e1/6d/f1/e16df1c4548b483a6aa6551999ecda8f.jpg",
          "736x": "https://i.pinimg.com/736x/e1/6d/f1/e16df1c4548b483a6aa6551999ecda8f.jpg",
          "originals": "https://i.pinimg.com/originals/e1/6d/f1/e16df1c4548b483a6aa6551999ecda8f.png"
        }
      },
      {
        "signature": "f9ffea000dce6fd87d83ac5717df494f",
        "dominant_color": "#263623",
        "resolutions": {
          "236x": "https://i.pinimg.com/236x/f9/ff/ea/f9ffea000dce6fd87d83ac5717df494f.jpg",
          "474x": "https://i.pinimg.com/474x/f9/ff/ea/f9ffea000dce6fd87d83ac5717df494f.jpg",
          "564x": "https://i.pinimg.com/564x/f9/ff/ea/f9ffea000dce6fd87d83ac5717df494f.jpg",
          "736x": "https://i.pinimg.com/736x/f9/ff/ea/f9ffea000dce6fd87d83ac5717df494f.jpg",
          "originals": "https://i.pinimg.com/originals/f9/ff/ea/f9ffea000dce6fd87d83ac5717df494f.png"
        }
      },
      {
        "signature": "a5986564499e6a8804feeca77dda3011",
        "dominant_color": "#485547",
        "resolutions": {
          "236x": "https://i.pinimg.com/236x/a5/98/65/a5986564499e6a8804feeca77dda3011.jpg",
          "474x": "https://i.pinimg.com/474x/a5/98/65/a5986564499e6a8804feeca77dda3011.jpg",
          "564x": "https://i.pinimg.com/564x/a5/98/65/a5986564499e6a8804feeca77dda3011.jpg",
          "736x": "https://i.pinimg.com/736x/a5/98/65/a5986564499e6a8804feeca77dda3011.jpg",
          "originals": "https://i.pinimg.com/originals/a5/98/65/a5986564499e6a8804feeca77dda3011.png"
        }
      },
      {
        "signature": "161b97e6721f4266324f1da78d31946e",
        "dominant_color": "#B8855A",
        "resolutions": {
          "236x": "https://i.pinimg.com/236x/16/1b/97/161b97e6721f4266324f1da78d31946e.jpg",
          "474x": "https://i.pinimg.com/474x/16/1b/97/161b97e6721f4266324f1da78d31946e.jpg",
          "564x": "https://i.pinimg.com/564x/16/1b/97/161b97e6721f4266324f1da78d31946e.jpg",
          "736x": "https://i.pinimg.com/736x/16/1b/97/161b97e6721f4266324f1da78d31946e.jpg",
          "originals": "https://i.pinimg.com/originals/16/1b/97/161b97e6721f4266324f1da78d31946e.png"
        }
      }
    ],
    "board_owner_username": "gilletteen",
    "board_owner_profile_url": "https://pinterest.com/gilletteen/",
    "board_owner_full_name": "Elizabeth Gillette",
    "board_owner_follower_count": 232,
    "board_owner_image_large_url": "https://i.pinimg.com/140x140_RS/79/af/a0/79afa0c37d61e89c66520cdc86418ae9.jpg",
    "story_pin_title": null,
    "story_page_count": null,
    "story_root_pin_id": null,
    "story_root_user_id": null,
    "story_original_pin_url": null,
    "has_video": true,
    "video_url": "https://v1.pinimg.com/videos/iht/hls/96/44/29/96442905124c7f898a74a677706d2f37.m3u8",
    "video_width": 718,
    "video_height": 1280,
    "video_duration_seconds": 6.3,
    "video_thumbnail_url": "https://i.pinimg.com/videos/thumbnails/originals/96/44/29/96442905124c7f898a74a677706d2f37.0000000.jpg",
    "link": "https://www.instagram.com/reel/C_zu27nyxYV/",
    "link_domain": "www.instagram.com"
  }
````

### Field reference

| Field | Description |
|---|---|
| 🔎 `query` | The search query that returned this pin |
| 🆔 `id` | Pinterest's internal pin ID |
| 🔗 `pin_url` | Direct link to the pin |
| 📝 `title` / `description` | Pin title and description text |
| 🗓 `created_at` | When the pin was created |
| 🎨 `dominant_color` | Dominant color of the image (hex) |
| 🔤 `seo_alt_text` / `auto_alt_text` | Alt text describing the image content |
| 📣 `is_promoted` | Whether the pin is a paid ad |
| 📦 `is_oos_product` | Whether a shopping pin's product is out of stock |
| ❤️ `reaction_counts` | Reaction counts by type |
| 🖼 `image_best_url/width/height` | Largest real image Pinterest returned |
| 📐 `image_resolutions` | Same image at every common resolution |
| 👤 `pinner_*` | Username, display name, follower count, profile URL of the pin's author |
| 📋 `board_*` | Board name, URL, pin count, cover images |
| 👑 `board_owner_*` | Same fields, but for the board's owner |
| ✨ `story_*` | Title, page count and original source, for Idea/Story Pins |
| 🎬 `video_*` / `has_video` | Video URL, thumbnail, dimensions and duration, if the pin is a video |
| 🌐 `link` / `link_domain` | External URL the pin points to (e.g. Instagram, a shop, a blog) and its domain |

### Do I need proxies to scrape Pinterest?

If you run the scraper on the Apify platform, residential proxies are recommended for stable, large-scale runs. For more details about pricing, platform credits, proxies and usage, see the [platform pricing page](https://apify.com/pricing/actors).

### Your feedback

We're always working on improving this scraper. If you've got technical feedback or found a bug, please create an issue on the Actor's **Issues** tab in Apify Console.

# Actor input Schema

## `queries` (type: `array`):

List of search terms to look up on Pinterest (e.g. "cars", "minimalist logo", "retro girls"). Each query is scraped separately.

## `resultsPerQuery` (type: `integer`):

Target number of pins to return for each search query. The actual count may vary slightly above or below this number (e.g. requesting 20 may return 18-25) because Pinterest returns results in fixed-size pages, and the scraper can't cut a page exactly at the requested number.

## Actor input object example

```json
{
  "queries": [
    "luxury cars"
  ],
  "resultsPerQuery": 100
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {
    "queries": [
        "luxury cars"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("dt_org/pinterest-scraper-by-search-query-detailed-output").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 = { "queries": ["luxury cars"] }

# Run the Actor and wait for it to finish
run = client.actor("dt_org/pinterest-scraper-by-search-query-detailed-output").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 '{
  "queries": [
    "luxury cars"
  ]
}' |
apify call dt_org/pinterest-scraper-by-search-query-detailed-output --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Pinterest Scraper by search query, detailed output",
        "description": "Scrape Pinterest pins detailed information(boards, users etc) from search results by queries. Extract images, videos, pinner data, pin onwer data, SEO metadata and many other fields. 40+ data fields per scraped pin with multi-resolution images.",
        "version": "0.1",
        "x-build-id": "RuxU3HDBTqxiqa4af"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/dt_org~pinterest-scraper-by-search-query-detailed-output/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-dt_org-pinterest-scraper-by-search-query-detailed-output",
                "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/dt_org~pinterest-scraper-by-search-query-detailed-output/runs": {
            "post": {
                "operationId": "runs-sync-dt_org-pinterest-scraper-by-search-query-detailed-output",
                "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/dt_org~pinterest-scraper-by-search-query-detailed-output/run-sync": {
            "post": {
                "operationId": "run-sync-dt_org-pinterest-scraper-by-search-query-detailed-output",
                "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": [
                    "queries",
                    "resultsPerQuery"
                ],
                "properties": {
                    "queries": {
                        "title": "Search queries",
                        "type": "array",
                        "description": "List of search terms to look up on Pinterest (e.g. \"cars\", \"minimalist logo\", \"retro girls\"). Each query is scraped separately.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "resultsPerQuery": {
                        "title": "Max results per query",
                        "minimum": 20,
                        "maximum": 2000,
                        "type": "integer",
                        "description": "Target number of pins to return for each search query. The actual count may vary slightly above or below this number (e.g. requesting 20 may return 18-25) because Pinterest returns results in fixed-size pages, and the scraper can't cut a page exactly at the requested number.",
                        "default": 100
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```