Pinterest Scraper & Downloader

Scrape and download images, videos and metadata from Pinterest boards, pins and search results. Extract thousands of pins in minutes — no login or browser required.

Why This Actor?

Most Pinterest scrapers only extract metadata. This one goes further — it downloads the actual images and videos alongside structured data. Get pin URLs, dimensions, alt text, video streams, and downloadable media files all in a single run.

What You Can Scrape

Source	Description
Board URLs	All pins from any public Pinterest board, including nested sections
Pin URLs	Related pins from any pin page
Search queries	Pins matching any keyword or phrase on Pinterest

What You Get

Every scraped pin includes:

• Pin ID — Unique Pinterest identifier
• Media URL — Direct link to the original image or video thumbnail
• Media type — Image or video
• Dimensions — Width and height in pixels
• Alt text — Image description from Pinterest
• Source URL — The board, pin, or search query where it was found
• Video URL — Direct video download link (for video pins)
• Video duration — Length of the video in seconds
• Scraped at — Timestamp of when the data was collected

How to Use

Scrape a Pinterest Board

{
  "startUrls": ["https://www.pinterest.com/pinterest/official-news/"],
  "maxItems": 100
}

Search Pinterest

{
  "searchQueries": ["minimalist interior design"],
  "maxItems": 50
}

Scrape Multiple Sources

{
  "startUrls": [
    "https://www.pinterest.com/username/recipes/",
    "https://www.pinterest.com/username/fitness/"
  ],
  "searchQueries": ["healthy breakfast ideas"],
  "maxItems": 200,
  "downloadMedia": true
}

Download Images and Videos

{
  "startUrls": ["https://www.pinterest.com/username/travel-inspiration/"],
  "maxItems": 500,
  "downloadMedia": true,
  "downloadVideos": true,
  "minWidth": 800,
  "minHeight": 600
}

Access Private Boards

Provide your Pinterest cookies in Selenium format to scrape boards behind a login:

{
  "startUrls": ["https://www.pinterest.com/username/private-board/"],
  "maxItems": 100,
  "cookies": "[{\"name\": \"_auth\", \"value\": \"1\", \"domain\": \".pinterest.com\", \"path\": \"/\"}]"
}

Input Fields

Sources

Field	Type	Default	Description
startUrls	array	[]	Pinterest board, board section, or pin URLs to scrape. Board URLs extract all pins from the board. Pin URLs extract related pins.
searchQueries	array	[]	Keywords to search on Pinterest. Each query returns matching pins.
maxItems	integer	100	Maximum number of pins to scrape across all URLs and queries combined.

Download Options

Field	Type	Default	Description
downloadMedia	boolean	false	Save images and videos to the key-value store. If disabled, only metadata is saved to the dataset.
downloadVideos	boolean	false	Download video pins alongside images. Only applies when media downloading is enabled above.
minWidth	integer	0	Skip images narrower than this (in pixels). Use 0 for no filtering. Helpful for excluding low-quality thumbnails.
minHeight	integer	0	Skip images shorter than this (in pixels). Use 0 for no filtering. Combine with minimum width to only keep high-resolution images.

Authentication

Field	Type	Default	Description
cookies	string	—	Pinterest session cookies as a JSON array for accessing private boards. Leave empty for public boards. Get cookies by logging into Pinterest in your browser and exporting the session cookies.

Advanced

Field	Type	Default	Description
delay	number	0.5	Wait time between consecutive requests (in seconds) to avoid rate limiting. Increase if you get blocked or receive empty results.
proxyConfiguration	object	Apify proxy	Apify proxy settings. Residential proxies are recommended for large scraping jobs to avoid blocks.

Output Example

{
  "id": "424605071130957254",
  "mediaUrl": "https://i.pinimg.com/originals/bc/a5/bf/bca5bfa991c16a187e0d6e582ecaa70f.png",
  "mediaType": "image",
  "width": 560,
  "height": 560,
  "altText": "Minimalist kitchen design with marble countertops",
  "sourceUrl": "https://www.pinterest.com/pinterest/official-news/",
  "videoUrl": null,
  "videoDuration": null,
  "scrapedAt": "2026-04-12T10:25:03.622218+00:00"
}

Downloaded Media Files

When downloadMedia is enabled, images and videos are saved to the Actor's Key-Value Store with keys like:

• media/424605071130957254.jpg
• media/987654321098765.mp4

Access them via the Key-Value Store tab after the run completes.

Performance & Limits

• Speed: Scrapes 50-100 pins per minute depending on source type
• Max items: Up to 10,000 pins per run
• Rate limiting: Built-in delays prevent Pinterest blocks
• No browser: Fast API-based scraping without Playwright/Selenium overhead

Use Cases

• Design inspiration — Build mood boards from Pinterest collections
• Market research — Analyze trending visual content in your niche
• Content curation — Aggregate images for blogs, presentations, or social media
• Dataset creation — Train ML models on Pinterest image data
• Competitor analysis — Monitor what competitors are pinning
• Backup boards — Archive your Pinterest boards locally

Tips for Best Results

1. Start small — Test with maxItems: 10 before running large scrapes
2. Use specific searches — Narrow queries get better results than broad ones
3. Filter by resolution — Set minWidth and minHeight to skip low-quality images
4. Enable proxy — Apify proxy is enabled by default to avoid rate limits
5. Increase delay — If you hit rate limits, increase delay to 1-2 seconds

Getting Cookies for Private Boards

To scrape private boards, you need to provide your Pinterest session cookies:

1. Log in to Pinterest in your browser
2. Open Developer Tools (F12)
3. Go to Application → Cookies → https://pinterest.com
4. Copy the _auth and _pinterest_sess cookies
5. Format them as a JSON array:

[
  {
    "name": "_auth",
    "value": "1",
    "domain": ".pinterest.com",
    "path": "/"
  },
  {
    "name": "_pinterest_sess",
    "value": "YOUR_SESSION_TOKEN_HERE",
    "domain": ".pinterest.com",
    "path": "/"
  }
]

6. Paste the JSON string into the cookies input field

Troubleshooting

No results returned?

• Check that the URL is correct and publicly accessible
• Try increasing maxItems — some boards have fewer pins than expected
• Verify cookies are valid if scraping private boards

Rate limited?

• Increase the delay parameter to 1-2 seconds
• Enable Apify proxy (enabled by default)
• Reduce maxItems for the current run

Images not downloading?

• Ensure downloadMedia is set to true
• Check the Key-Value Store tab for downloaded files
• Some images may fail due to broken URLs (check kvStoreStats in logs)

---

Questions or issues? Contact the Actor developer through the Apify platform.