Pinterest Video Downloader

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

Features

• Two modes — search for video pins by keyword or download from specific pin URLs
• Quality options — 720p (high), 480p (medium), or HLS stream
• Story pin support — downloads videos from both standard video pins and story pins
• Rich metadata — title, description, pinner, board, duration, thumbnail, engagement stats
• Key-Value Store download — videos saved as binary files with their pin ID as key
• Dataset metadata — optionally record video metadata alongside the KV store download
• Cloud-ready — runs on Apify with scheduling, proxy rotation, and webhook support

Use Cases

• Building video datasets for machine learning or content analysis
• Downloading Pinterest video pins for offline use or repurposing
• Visual content research and trend monitoring
• Collecting video assets from a specific niche or topic

Input

Field	Type	Default	Required	Description
mode	string	search		search to find video pins by keyword, or pinUrls to download specific pins.
query	string	—		Search keyword to find video pins. Used when mode is search.
pinUrls	array	—		List of Pinterest pin URLs containing videos. Used when mode is pinUrls.
maxItems	integer	20		Maximum number of videos to download (up to 200).
videoQuality	string	V_720P		Video quality: V_720P (720p), V_480P (480p), or V_HLS (HLS stream).
saveToDataset	boolean	true		Also save video metadata to the dataset.
proxyConfiguration	object	Apify Proxy		Proxy settings. Residential proxies are strongly recommended.

Output

Each downloaded video entry includes:

Field	Description
pinId	Pinterest pin ID
title	Pin title
description	Pin description text
pinUrl	Full URL to the pin
destinationUrl	External link destination
videoUrl	URL of the downloaded video
videoQuality	Quality selected (V_720P, V_480P, V_HLS)
videoUrl480p	480p video URL (if available)
videoUrlHls	HLS stream URL (if available)
duration	Video duration in milliseconds
thumbnailUrl	Video thumbnail/cover image URL
isStoryPin	Whether this is a story pin video
dominantColor	Dominant color hex code of the thumbnail
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
kvStoreKey	Key under which the video is saved in KV Store
downloaded	Whether the video was successfully downloaded
fileSize	File size in bytes (when available)
createdAt	Pin creation timestamp
scrapedAt	ISO 8601 timestamp of scrape

Sample Output

{
  "pinId": "112233445",
  "title": "Morning Yoga Flow for Beginners",
  "description": "Start your day with this 10-minute yoga routine.",
  "pinUrl": "https://www.pinterest.com/pin/112233445/",
  "videoUrl": "https://v.pinimg.com/720p/ab/cd/ef/abcdef.mp4",
  "videoQuality": "V_720P",
  "duration": 600000,
  "thumbnailUrl": "https://i.pinimg.com/736x/ab/cd/ef.jpg",
  "isStoryPin": false,
  "saves": 3200,
  "pinnerUsername": "yogawithsarah",
  "boardName": "Morning Routines",
  "kvStoreKey": "video_112233445",
  "downloaded": true,
  "scrapedAt": "2026-05-21T10:00:00.000Z"
}

Notes

• KV Store: Downloaded videos are stored in Apify Key-Value Store under the key video_<pinId>. Access via the Apify Console or API.
• Proxy: Residential proxy is strongly recommended — set proxyConfiguration: { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }.
• Video quality: If V_720P is not available for a pin, the actor automatically falls back to V_480P then V_HLS.
• Story pins: Videos in Pinterest Story Pins are also supported and treated as regular video pins.
• Search scope: The search mode queries Pinterest for video pins matching your keyword. Not all search queries return video pins — use topic-specific queries (e.g. "cooking tutorial video", "yoga routine", "DIY craft video") for best results. Generic queries like "nature" may return mostly image pinsutorial video", "yoga routine", "DIY craft video") for best results. Generic queries like "nature"` may return mostly image pins.