Automatically upload as many Pins as you want to Pinterest.

• (Version 1.1 - December 27, 2021).
• Note: The upload limit on Pinterest is about 150 pins in a row.
  You can do multiple upload sessions in a day but risk having your account suspended.

This script is not maintained anymore. If you want to make some corrections concerning the input of images/videos and the selection of the Pinboard, I can integrate them into the script.

Table of contents:

• Changelog.
• What does this bot do?
• To do list.
• Instructions.
  • Basic installation of Python for beginners.
  • Configuration of the bot.
• Known issues.
• Data files structure.

Changelog:

• Version 1.1:

  • Pinboard issue fixed.
  • Description issue fixed.
  • Minor bugs fixed.

• Version 1.0:

  • Inital commit.

What does this bot do?

This script allows you to upload as many Pins (150 in a row) as you want to Pinterest, all automatically and quickly (about 4 Pins per minute).
The upload limit on Pinterest is about 150 pins in a row. You can do multiple upload sessions in a day but risk having your account suspended.

To do list:

• ✔ Pinterest automatic login.
• ❌ Pinterest two-factor authentication support.
• ✔ Automatic Pins uploader.
• ✔ Data file browsing feature.
• ✔ CSV structure reader and interpreter.
• ✔ JSON structure reader and interpreter.

Instructions:

• Basic installation of Python for beginners:

  • Download this repository or clone it:

git clone https://github.com/maximedrn/pinterest-automatic-uploader.git

• It requires Python 3.7 or a newest version.
• Install pip to be able to have needed Python modules.
• Open a command prompt in repository folder and type:

pip install -r requirements.txt

• Configuration of bot:

  • Download and install Google Chrome.
  • Download the ChromeDriver executable that is compatible with the actual version of your Google Chrome browser and your OS (Operating System). Refer to: What version of Google Chrome do I have?
  • Extract the executable from the ZIP file and copy/paste it in the assets/ folder of the repository. You may need to change the path of the file:

class Pinterest:
    """Main class of the Pinterest uploader."""

    def __init__(self, email: str, password: str) -> None:
        """Set path of used file and start webdriver."""
        self.email = email  # Pinterest email.
        self.password = password  # Pinterest password.
        self.webdriver_path = os.path.abspath('assets/chromedriver.exe')  # Edit this line with your path.
        self.driver = self.webdriver()  # Start new webdriver.
        self.login_url = 'https://www.pinterest.com/login/'
        self.upload_url = 'https://www.pinterest.com/pin-builder/'

• Optional: the email and the password are asked when you run the bot, but you can:
  • create and open the assets/email.txt file, and then write your Pinterest email;
  • create and open the assets/password.txt file, and then write your Pinterest password.
• Create your Pins data file containing all details of each Pin. It can be a JSON or CSV file. Save it in the data folder.
  What structure should the files have?

Known issues:

• If you are using a Linux distribution or MacOS, you may need to change some parts of the code:
  • ChromeDriver extension may need to be changed from .exe to something else.
• If you use a JSON file for your Pins data, the file path should not contain a unique "\". It can be a "/" or a "\\":

"file_path": "C:/Users/Admin/Desktop/Pinterest/image.png",
// or:
"file_path": "C:\\Users\\Admin\\Desktop\\Pinterest\\image.png",
// but not:
"file_path": "C:\Users\Admin\Desktop\Pinterest\image.png", // You can see that "\" is highlighted in red.

• Data files structure:

  • required value *
  
  

  Settings	Types	Examples
  Pinboard *	String
  File Path *	String
  Title *	String (maximum 100 characters).
  Description	String (maximum 500 characters).
  Alt text	String (maximum 500 characters).
  Link	String
  Date	String (Maximum 14 days later) (Format: DD/MM/YYYY HH:MM).	"01/01/2022 12:00" or "01/01/2022 15:30"

  You should have something like this: JSON, CSV.