This library facilitates the scraping and downloading of images from Pinterest. Using Selenium and reverse engineered Pinterest API for automation, it enables users to extract images from a specified Pinterest URL and save them to a chosen directory.
It includes a CLI for direct usage and a Python API for programmatic access. The tool supports scraping images from public and private boards and pins using browser cookies. It also allows users to save scraped URLs to a JSON file for future access.
⚠️ Disclaimer:
This project is independent and not affiliated with Pinterest. It's designed solely for educational purposes. Please be aware that automating the scraping of websites might conflict with their Terms of Service. The repository owner disclaims any liability for misuse of this tool. Use it responsibly and at your own legal risk.
🗒️ Note:
This project draws inspiration from pinterest-image-scraper.
- ✅ Scrape images directly from a Pinterest URL.
- ✅ Asynchronously download images from a list of URLs. (#1)
- ✅ Save scraped URLs to a JSON file for future access.
- ✅ Incognito mode to keep your scraping discreet.
- ✅ Access detailed output for effective debugging.
- ✅ Support for the Firefox browser.
- ✅ Insert
alttext for images as metadatacommentin the downloaded image for searchability. - ✅ Scrape private boards and pins with browser cookies. (#20)
- ✅ Scrape images using reversed engineered Pinterest API. (This will be default behaviour. You can use webdriver by specifying
--client chromeor--client firefox) (#21)
🔲 Incompatibility with Pinterest URLs that include search queries.Implementedsearchcommand sincev0.3.0. (#23)- 🔲 Not sorely tested on Linux and Mac. Please create an Issue to report any bugs.
- Python 3.10 or newer
- Chrome or Firefox browser
pip install pinterest-dlgit clone https://github.com/sean1832/pinterest-dl.git
cd pinterest-dl
pip install .pinterest-dl [command] [options]Scraping Images in anonymous mode:
Scrape images in anonymous mode, without login, to the ./images/art directory from the Pinterest URL https://www.pinterest.com/pin/1234567 with a limit of 30 images and a minimum resolution of 512x512. Save scraped URLs to a JSON file.
pinterest-dl scrape "https://www.pinterest.com/pin/1234567" "images/art" -l 30 -r 512x512 --jsonGet Browser Cookies:
Get browser cookies for Pinterest login and save them to the cookies.json file in headful mode (with browser window).
pinterest-dl login -o cookies.json --headfulTip
You will be prompted to enter your Pinterest email and password. The tool will save the browser cookies to the specified file for future use.
Scraping Private Boards:
Scrape images from a private Pinterest board using the cookies saved in the cookies.json file.
pinterest-dl scrape "https://www.pinterest.com/pin/1234567" "images/art" -l 30 -c cookies.jsonTip
You can use the --client option to use chrome or firefox Webdriver for scraping. This is slower but more reliable.
It will open a browser in headless mode to scrape images. You can also use the --headful flag to run the browser in windowed mode.
Downloading Images:
Download images from the art.json file to the ./downloaded_imgs directory with a minimum resolution of 1024x1024.
pinterest-dl download art.json -o downloaded_imgs -r 1024x1024Login to Pinterest using your credentials to obtain browser cookies for scraping private boards and pins.
Syntax:
pinterest-dl login [options]
Options:
-o,--output [file]: File to save browser cookies for future use. (default:cookies.json)--client: Choose the scraping client (chrome/firefox). (default:chrome)--headful: Run in headful mode with browser window.--verbose: Enable detailed output for debugging.--incognito: Activate incognito mode for scraping.
Tip
After entering login command, you will be prompted to enter your Pinterest email and password.
The tool will then save the browser cookies to the specified file for future use. (if not specified, it will save to ./cookies.json)
Extract images from a specified Pinterest URL.
Syntax:
pinterest-dl scrape [url] [output_dir] [options]
Options:
-c,--cookies [file]: File containing browser cookies for private boards/pins. Runlogincommand to obtain cookies.-l,--limit [number]: Max number of image to download (default: 100).-r,--resolution [width]x[height]: Minimum image resolution for download (e.g., 512x512).--timeout [second]: Timeout in seconds for requests (default: 3).--json: Save scraped URLs to a JSON file.--dry-run: Execute scrape without downloading images.--verbose: Enable detailed output for debugging.--client: Choose the scraping client (api/chrome/firefox). (default: api)--incognito: Activate incognito mode for scraping. (chrome / firefox only)--headful: Run in headful mode with browser window. (chrome / firefox only)
Search for images on Pinterest using a query. (Experimental, currently only available in API mode)
Syntax:
pinterest-dl search [query] [output_dir] [options]
Options:
-c,--cookies [file]: File containing browser cookies for private boards/pins. Runlogincommand to obtain cookies.-l,--limit [number]: Max number of image to download (default: 100).-r,--resolution [width]x[height]: Minimum image resolution for download (e.g., 512x512).--timeout [second]: Timeout in seconds for requests (default: 3).--json: Save scraped URLs to a JSON file.--dry-run: Execute scrape without downloading images.--verbose: Enable detailed output for debugging.
Download images from a list of URLs provided in a file.
Syntax:
pinterest-dl download [url_list] [options]
Options:
-o,--output [directory]: Output directory (default: ./<json_filename>).-r,--resolution [width]x[height]: minimum resolution to download (e.g. 512x512).--verbose: Enable verbose output.
You can also use the PinterestDL class directly in your Python code to scrape and download images programmatically.
The following example shows how to scrape and download images from a Pinterest URL in one step.
from pinterest_dl import PinterestDL
# Initialize and run the Pinterest image downloader with specified settings
images = PinterestDL.with_api(
timeout=3, # Timeout in seconds for each request (default: 3)
verbose=False, # Enable detailed logging for debugging (default: False)
).scrape_and_download(
url="https://www.pinterest.com/pin/1234567", # Pinterest URL to scrape
output_dir="images/art", # Directory to save downloaded images
limit=30, # Max number of images to download
min_resolution=(512, 512), # Minimum resolution for images (width, height) (default: None)
json_output="art.json", # File to save URLs of scraped images (default: None)
dry_run=False, # If True, performs a scrape without downloading images (default: False)
add_captions=True, # Adds image `alt` text as metadata to images (default: False)
)2a. Obtain cookies You need to first log in to Pinterest to obtain browser cookies for scraping private boards and pins.
import os
import json
from pinterest_dl import PinterestDL
# Make sure you don't expose your password in the code.
email = input("Enter Pinterest email: ")
password = os.getenv("PINTEREST_PASSWORD")
# Initialize browser and login to Pinterest
cookies = PinterestDL.with_browser(
browser_type="chrome",
headless=True,
).login(email, password).get_cookies(
after_sec=7, # Time to wait before capturing cookies. Login may take time.
)
# Save cookies to a file
with open("cookies.json", "w") as f:
json.dump(cookies, f, indent=4)2b. Scrape with cookies After obtaining cookies, you can use them to scrape private boards and pins.
import json
from pinterest_dl import PinterestDL
# Load cookies from a file
with open("cookies.json", "r") as f:
cookies = json.load(f)
# Initialize and run the Pinterest image downloader with specified settings
images = (
PinterestDL.with_api()
.with_cookies(
cookies, # cookies in selenium format
)
.scrape_and_download(
url="https://www.pinterest.com/pin/1234567", # Assume this is a private board URL
output_dir="images/art", # Directory to save downloaded images
limit=30, # Max number of images to download
)
)Use this example if you need more granular control over scraping and downloading images.
import json
from pinterest_dl import PinterestDL
# 1. Initialize PinterestDL with API.
scraped_images = PinterestDL.with_api().scrape(
url="https://www.pinterest.com/pin/1234567", # URL of the Pinterest page
limit=30, # Maximum number of images to scrape
min_resolution=(512, 512), # <- Only available to set in the API. Browser mode will have to pruned after download.
)
# 2. Save Scraped Data to JSON
# Convert scraped data into a dictionary and save it to a JSON file for future access
images_data = [img.to_dict() for img in scraped_images]
with open("art.json", "w") as f:
json.dump(images_data, f, indent=4)
# 3. Download Images
# Download images to a specified directory
downloaded_imgs = PinterestDL.download_images(images=scraped_images, output_dir="images/art")
valid_indices = list(range(len(downloaded_imgs))) # All images are valid to add captions
# 4. Add Alt Text as Metadata
# Extract `alt` text from images and set it as metadata in the downloaded files
PinterestDL.add_captions(images=downloaded_imgs, indices=valid_indices)import json
from pinterest_dl import PinterestDL
# 1. Initialize PinterestDL with API.
scraped_images = PinterestDL.with_browser(
browser_type="chrome", # Browser type to use ('chrome' or 'firefox')
headless=True, # Run browser in headless mode
).scrape(
url="https://www.pinterest.com/pin/1234567", # URL of the Pinterest page
limit=30, # Maximum number of images to scrape
)
# 2. Save Scraped Data to JSON
# Convert scraped data into a dictionary and save it to a JSON file for future access
images_data = [img.to_dict() for img in scraped_images]
with open("art.json", "w") as f:
json.dump(images_data, f, indent=4)
# 3. Download Images
# Download images to a specified directory
downloaded_imgs = PinterestDL.download_images(images=scraped_images, output_dir="images/art")
# 4. Prune Images by Resolution
# Remove images that do not meet the minimum resolution criteria
valid_indices = PinterestDL.prune_images(images=downloaded_imgs, min_resolution=(200, 200))
# 5. Add Alt Text as Metadata
# Extract `alt` text from images and set it as metadata in the downloaded files
PinterestDL.add_captions(images=downloaded_imgs, indices=valid_indices)