Pinterest Downloader 📌

A beautiful CLI tool for downloading images from Pinterest boards, pins, and search results.

Features

• 🎨 Beautiful CLI - Rich terminal output with progress bars and tables
• 📥 Download boards - Download all images from a Pinterest board
• 🔍 Search & download - Search Pinterest and download results
• 👤 User boards - List all boards for a user
• 🎯 Interactive mode - Guided download experience
• 🔐 Private boards - Login support for private boards
• 🎬 Video support - Download videos when available
• 📏 Resolution filter - Filter by minimum resolution

Installation

pip install -r requirements.txt

Usage

Download from a board

python main.py download https://pinterest.com/username/board-name -o ./images -n 100

Search and download

python main.py search "cute cats" -o ./cats -n 50

List user boards

python main.py user username

Interactive mode

python main.py interactive

Login for private boards

python main.py login -o cookies.json
python main.py download <private-board-url> --cookies cookies.json

Options

Download command

Option	Description
-o, --output	Output directory (default: ./downloads)
-n, --num	Maximum images to download (default: 100)
-r, --resolution	Minimum resolution (e.g., 512x512)
--video	Download videos if available
-c, --cookies	Path to cookies file for private boards
--client	Scraping client: api/chrome/firefox
--timeout	Request timeout in seconds
--delay	Delay between requests
-v, --verbose	Enable verbose output

Search command

Option	Description
-o, --output	Output directory
-n, --num	Maximum images (default: 50)
-r, --resolution	Minimum resolution
--video	Download videos
-c, --cookies	Cookies file path

Examples

# Download 50 images from a board
python main.py download https://pinterest.com/johndoe/cats -n 50

# Search for landscape photos with minimum resolution
python main.py search "landscape photography" -n 100 -r 1920x1080

# Interactive mode
python main.py interactive

# List all boards for a user
python main.py user johndoe

# Download from private board
python main.py login
python main.py download https://pinterest.com/me/private-board --cookies cookies.json

Credits

Powered by pinterest-dl