# Pinterest Boards Scraper (`easyapi/pinterest-boards-scraper`) Actor

The Pinterest Boards Scraper is an essential tool for discovering and exploring creative collections on Pinterest. With customizable search options and detailed data retrieval, it enhances your ability to find and utilize inspiring content effectively! 🌟

- **URL**: https://apify.com/easyapi/pinterest-boards-scraper.md
- **Developed by:** [EasyApi](https://apify.com/easyapi) (community)
- **Categories:** Social media
- **Stats:** 139 total users, 3 monthly users, 33.3% runs succeeded, 3 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $2.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

### 📌 Pinterest Boards Scraper

Discover and explore creative collections with our **Pinterest Boards Scraper**! This actor allows you to retrieve boards related to your query, providing access to a wide array of curated content.

#### 🌟 Key Features

- **Targeted Board Retrieval**: Search for boards based on specific keywords to find relevant collections of pins.
- **Customizable Input**: Simply provide a query to receive a list of boards related to your interests.

#### 🛠️ Data Fields Returned

Our scraper retrieves a variety of fields for each board, including:

- **id**: Unique identifier for the board.
- **name**: Name of the board.
- **coverURL**: URL to the cover image of the board.
- **thumbnailURL**: URL to the thumbnail image of the board.
- **thumbnailImagesURL**: An array of URLs for thumbnail images associated with the board.
- **slashURL**: Direct link to the board's page on Pinterest.
- **pinCount**: Total number of pins within the board.
- **type**: Type of content (e.g., "board").
- **owner**:
  - **id**: Unique identifier for the owner of the board.
  - **username**: Username of the board owner.
  - **fullName**: Full name of the board owner.
  - **avatarURL**: URL to the owner's avatar image.
  - **followers**: Number of followers the board owner has.

#### 🚀 Why Choose Our Scraper?

- **Efficient Content Discovery**: Quickly find and explore boards that match your interests and creative needs.
- **User-Friendly Integration**: Designed to seamlessly integrate into your applications or content management systems.
- **Comprehensive Insights**: Access detailed information about each board and its owner to enhance your understanding of Pinterest content.


#### Input
  
  A full explanation of an input example in JSON.  
  
````

{
"query": "wallpaper"
}

```

#### Output sample

The results will be wrapped into a dataset which you can always find in the **Storage** tab. Here's an excerpt from the data you'd get if you apply the input parameters above:  

And here is the same data but in JSON. You can choose in which format to download your data: JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML.  

```

\[
{
"id": "652670239687090888",
"name": "Wallpapers",
"coverURL": "https://i.pinimg.com/550x/dd/2c/b9/dd2cb9efee850da9b80db88a3aad0b67.jpg",
"thumbnailURL": "https://i.pinimg.com/upload/652670239687090888\_board\_thumbnail\_2024-09-05-21-05-16\_83548\_60.jpg",
"thumbnailImagesURL": \[
"https://i.pinimg.com/150x150/a4/37/1c/a4371cf5ade15e40ea08993e5b016d24.jpg",
"https://i.pinimg.com/150x150/09/2c/44/092c44e4ac7fad0353af85574f9a1f97.jpg",
"https://i.pinimg.com/150x150/87/4c/35/874c350a91349032aca853e3dac4b744.jpg",
"https://i.pinimg.com/150x150/5e/f4/3b/5ef43bf2f4bae1e6a578bf776e88bacf.jpg",
"https://i.pinimg.com/150x150/15/d7/7e/15d77e3f392ff381c01a413bbd4587b2.jpg"
],
"slashURL": "/ytechbofficial/wallpapers/",
"pinCount": 8261,
"type": "board",
"owner": {
"id": "652670308406330517",
"username": "ytechbofficial",
"fullName": "YTECHB | iPhone Wallpapers | Aesthetic Wallpapers Hub",
"avatarURL": "https://i.pinimg.com/140x140\_RS/6a/e8/2c/6ae82c8279f1bd14310cac2d68e29808.jpg",
"followers": 237419
}
},
...
]

````

### Related Actors

- 📌 [Pinterest Profile Scraper](https://apify.com/easyapi/pinterest-profile-scraper) - Extract Pinterest user profiles data including follower count, pin count, boards, and other public information.
- 📌 [Pinterest Followers Scraper](https://apify.com/easyapi/pinterest-followers-scraper) - Extract Pinterest followers data including usernames, full names and profile images.
- 👥 [Pinterest Following Scraper](https://apify.com/easyapi/pinterest-following-scraper) - Extract detailed profile information from Pinterest users' following lists.
- 🔍 [Pinterest Search Scraper](https://apify.com/easyapi/pinterest-search-scraper) - The Pinterest Search Scraper is an essential tool for discovering visual content on Pinterest.
- 🎯 [Pinterest Keyword Autocomplete Scraper](https://apify.com/easyapi/pinterest-keyword-autocomplete-scraper) - Essential tool for discovering keyword suggestions on Pinterest.
- 🌟 [Pinterest Comments Scraper](https://apify.com/easyapi/pinterest-comments-scraper) - Gather user feedback from Pinterest pins with detailed comment and author information.
- 📸 [Pinterest Image Downloader](https://apify.com/easyapi/pinterest-image-downloader) - Easily download high-quality images from Pinterest with batch downloading capabilities.
- 🎥 [Pinterest Video Downloader](https://apify.com/easyapi/pinterest-video-downloader) - Easily download high-quality videos from Pinterest with batch downloading support.
- 🔍 [Social Media Hashtag Generator](https://apify.com/easyapi/social-media-hashtag-generator) - Generate top, random, or live hashtags for multiple social media platforms.
- 📧 [All-in-One Social Media Email Scraper](https://apify.com/easyapi/all-in-one-social-media-email-scraper) - Discover emails across 30+ social platforms including Pinterest.
- 📱 [Social Media Influencer Scraper](https://apify.com/easyapi/social-media-influencer-scraper) - Discover top influencers across social media platforms including Pinterest.
- 🔍 [Keyword Suggestions Scraper](https://apify.com/easyapi/keyword-suggestions-scraper) - Scrape keyword suggestions from multiple platforms including Pinterest.
- 📊 [Article Content Extractor](https://apify.com/easyapi/article-content-extractor) - Extract clean content and metadata from any web page including Pinterest.
- 📧 [Email & Contact Extractor From Any Web](https://apify.com/easyapi/email-contact-extractor-from-any-web) - Extract emails and contact information from any website including Pinterest.
- 🔍 [URL Metadata Crawler](https://apify.com/easyapi/url-metadata-crawler) - Extract comprehensive metadata from web pages including Pinterest pins and boards.

# Actor input Schema

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

The Query Term

## Actor input object example

```json
{
  "query": "wallpaper"
}
````

# 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 = {
    "query": "wallpaper"
};

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

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

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Pinterest Boards Scraper",
        "description": "The Pinterest Boards Scraper is an essential tool for discovering and exploring creative collections on Pinterest. With customizable search options and detailed data retrieval, it enhances your ability to find and utilize inspiring content effectively! 🌟",
        "version": "0.0",
        "x-build-id": "Q94OCGIMuFdofOAeF"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/easyapi~pinterest-boards-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-easyapi-pinterest-boards-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/easyapi~pinterest-boards-scraper/runs": {
            "post": {
                "operationId": "runs-sync-easyapi-pinterest-boards-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/easyapi~pinterest-boards-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-easyapi-pinterest-boards-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": "The Query Term",
                        "type": "string",
                        "description": "The Query Term",
                        "default": "wallpaper"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```