This PHP library will help you to work with your Pinterest account without using any API account credentials.

To have an access to Pinterest API you need to go to developers.pinterest.com and register as a developer, then register your application, then wait for confirmation, and only then you will get an access token. Furthermore, its public API is very poor and has a very limited set of features. With this library you have the entire set of functions, which available on Pinterest website. And there is no need to register an application to receive an access token. Just use your account login and password, like you do it in your browser. But even your account is not required, if you don't use such operations as creating pins, writing comments or sending messages!

Programming language: PHP
License: MIT License
Tags: API     Bots     Pinterest     Lib    
Latest version: v5.9.1

Pinterest Bot for PHP alternatives and similar libraries

Based on the "API" category.
Alternatively, view Pinterest Bot for PHP alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of Pinterest Bot for PHP or a related project?

Add another 'API' Library


Pinterest Bot for PHP

A PHP library to help you work with your Pinterest account without API credentials.

The Pinterest API is painful: receiving an access token involves registering a developer account, registering an application, then waiting for confirmation. Not to mention, the public API itself is poorly implemented and has a limited set of features.

This library offers the full functionality available on Pinterest's website, with no need to register an application to receive an access token. All that's needed is your account login information (but even this is not required if you don't plan on creating pins, writing comments or sending messages)!

  • Installation
  • Quick Start
  • How to avoid ban
  • Examples
  • [Account](docs/account.md)
  • [Boards](docs/boards.md)
  • [Pins](docs/pins.md)
  • [Pinners](docs/pinners.md)
  • [Interests and topics](docs/interests-and-topics.md)
  • [Search](docs/search.md)
  • [Inbox](docs/inbox.md)
  • [Keywords](docs/keywords.md)
  • [Error handling](docs/errors-handling.md)
  • [Use proxy](docs/proxy.md)
  • [Custom request settings](docs/custom-request.md)
  • [Cookies](docs/cookes.md)
  • [Pagination](docs/pagination.md)



Library requires CURL extension and PHP 7.0 or above.

The recommended way to install this library is via Composer. New to Composer?

composer require seregazhuk/pinterest-bot

Quick Start

// You may need to amend this path to locate Composer's autoloader

use seregazhuk\PinterestBot\Factories\PinterestBot;

$bot = PinterestBot::create();

// Login
$bot->auth->login('mypinterestlogin', 'mypinterestpassword');

// Get lists of your boards
$boards = $bot->boards->forUser('yourUserName');

// Create a pin
$bot->pins->create('http://exmaple.com/image.jpg', $boards[0]['id'], 'Pin description');

Note: Some methods (e.g. get user followers/following, pins likes/dislikes, search and other feed queries) use Pinterest navigation through results (with bookmarks). This means that for every batch of results, a call is made to Pinterest and a Pagination object with Pinterest API results is returned.

How to avoid ban

To avoid being banned by Pinterest, do not aggressively pin or write comments (e.g. creating hundreds of pins in a single minute). Do this by inserting timeouts (sleep($seconds)) with calls.


These articles provide examples of common tasks that can be performed with the bot:

How can I thank you?

Why not star this GitHub repo? I'd love the attention! Or, you can donate to my project on PayPal:

Support me with some coffee