Pinterest Image Downloader

Downloads high-quality images from Pinterest pins via keyword search or specific pin URLs. Saves images to Apify Key-Value Store and optionally records metadata (title, pinner, board, dimensions) in the dataset — ideal for building image datasets, creative asset libraries, and visual content research.

Features

• Two modes — search by keyword or provide specific pin URLs
• Multiple quality options — original, 736px, 474px, or 236px wide
• Rich metadata — title, description, hashtags, pinner, board, dominant color, engagement stats
• Key-Value Store download — images saved as binary files with their pin ID as key
• Dataset metadata — optionally record image metadata alongside the KV store download
• Cloud-ready — runs on Apify with scheduling, optional proxy configuration, and webhook support

Use Cases

• Building image datasets for machine learning training
• Creative asset collection and mood board building
• Visual content research and trend analysis
• Downloading pin images for offline use or design projects

Input

Field	Type	Default	Required	Description
mode	string	search		search to find images by keyword, or pinUrls to download specific pins.
query	string	—		Search keyword to find pins. Used when mode is search.
pinUrls	array	—		List of Pinterest pin URLs to download. Used when mode is pinUrls.
maxItems	integer	50		Maximum number of images to download (up to 500).
imageQuality	string	original		Image quality: original, 736x, 474x, or 236x.
saveToDataset	boolean	true		Also save image metadata to the dataset.
proxyConfiguration	object	direct connection		Optional proxy settings. Set useApifyProxy to true when needed.

Output

Each downloaded image entry includes:

Field	Description
pinId	Pinterest pin ID
title	Pin title
description	Pin description text
altText	Image alt text
hashtags	Array of hashtags
pinUrl	Full URL to the pin
destinationUrl	External link destination
imageUrl	URL of the downloaded image
imageQuality	Quality/size selected (original, 736x, etc.)
imageWidth	Image width in pixels
imageHeight	Image height in pixels
imageOrigUrl	Original resolution image URL
image736Url	736px wide image URL
image474Url	474px wide image URL
image236Url	236px wide image URL
dominantColor	Dominant color hex code
saves	Number of saves/repins
likeCount	Number of likes
commentCount	Number of comments
pinnerId	Pinner's user ID
pinnerUsername	Pinner's Pinterest username
pinnerFullName	Pinner's display name
boardId	Board ID the pin belongs to
boardName	Board name
boardUrl	Full URL to the board
sourceDomain	Source domain of the original content
kvStoreKey	Key under which the image is saved in KV Store
downloaded	Whether the image was successfully downloaded
createdAt	Pin creation timestamp
scrapedAt	ISO 8601 timestamp of scrape

Sample Output

{
  "pinId": "135792468",
  "title": "Minimalist Nordic Living Room",
  "description": "Clean lines and neutral tones for a calm home.",
  "pinUrl": "https://www.pinterest.com/pin/135792468/",
  "imageUrl": "https://i.pinimg.com/originals/12/34/56/123456.jpg",
  "imageQuality": "original",
  "imageWidth": 1080,
  "imageHeight": 1350,
  "dominantColor": "#F5F5F0",
  "saves": 4200,
  "pinnerUsername": "homedecorinspo",
  "boardName": "Living Room Ideas",
  "kvStoreKey": "image_135792468",
  "downloaded": true,
  "scrapedAt": "2026-05-21T10:00:00.000Z"
}

Notes

• KV Store: Downloaded images are stored in Apify Key-Value Store under the key image_<pinId>. Access via the Apify Console or API.
• Proxy: Direct connections are used by default. You can enable Apify Proxy with proxyConfiguration: { "useApifyProxy": true }; the dataset records whether a proxy was actually configured.
• Image quality: original provides the highest resolution available on Pinterest (varies per pin). Use 736x for a good balance of quality and file size.
• Scheduling: Use Apify Scheduler to regularly collect new images for a specific search query.