PHPackages mjphaynes/pinterest-bot - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. mjphaynes/pinterest-bot ActivePackage[Utility & Helpers](/categories/utility) mjphaynes/pinterest-bot ======================= PHP library for Pintrest v5.9.2(5y ago)14.9kMITPHPPHP >=7.0 Since Aug 14Pushed 5y agoCompare [ Source](https://github.com/mjphaynes/php-pinterest-bot)[ Packagist](https://packagist.org/packages/mjphaynes/pinterest-bot)[ RSS](/packages/mjphaynes-pinterest-bot/feed)WikiDiscussions master Synced today READMEChangelogDependencies (3)Versions (147)Used By (0) Pinterest Bot for PHP ===================== [](#pinterest-bot-for-php) [![Pinterest PHP Bot](logo.jpg)](logo.jpg) [![Build Status](https://camo.githubusercontent.com/412fbc5888a7d03937daf554d662678477512375/68747470733a2f2f7472617669732d63692e6f72672f7365726567617a68756b2f7068702d70696e7465726573742d626f742e737667)](https://travis-ci.org/seregazhuk/php-pinterest-bot)[![Code Climate](https://camo.githubusercontent.com/d30f6b154177d3a589af46e154b31ec66ef05128/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f7365726567617a68756b2f7068702d70696e7465726573742d626f742f6261646765732f6770612e737667)](https://codeclimate.com/github/seregazhuk/php-pinterest-bot)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/c05b7ed73a9c49224fb982888fc7ac643fbec5f6/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f7365726567617a68756b2f7068702d70696e7465726573742d626f742f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/seregazhuk/php-pinterest-bot/?branch=master)[![Test Coverage](https://camo.githubusercontent.com/704321dd17ccb2c5de0e954e1c29a8cefa2572be/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f7365726567617a68756b2f7068702d70696e7465726573742d626f742f6261646765732f636f7665726167652e737667)](https://codeclimate.com/github/seregazhuk/php-pinterest-bot/coverage)[![StyleCI](https://camo.githubusercontent.com/f87fcf43f682a8fa9333ca724463ec43f3e4e65cf552d6ffb71d7884ea9d9eab/68747470733a2f2f7374796c6563692e696f2f7265706f732f33393535373938352f736869656c643f6272616e63683d6d6173746572)](https://styleci.io/repos/39557985)[![](https://camo.githubusercontent.com/724582c12ac5b951676262ce6c357a4f23a682a2722c2e53ac21f960d76d3162/68747470733a2f2f706f7365722e707567782e6f72672f7365726567617a68756b2f70696e7465726573742d626f742f762f737461626c65)](https://packagist.org/packages/seregazhuk/pinterest-bot)[![Total Downloads](https://camo.githubusercontent.com/8957462146926452326740b5c6255bbdb3abea67/68747470733a2f2f706f7365722e707567782e6f72672f7365726567617a68756b2f70696e7465726573742d626f742f646f776e6c6f616473)](https://packagist.org/packages/seregazhuk/pinterest-bot) 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](#installation) - [Quick Start](#quick-start) - [How to avoid ban](#how-to-avoid-ban) - [Examples](#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) Installation ------------ [](#installation) ### Dependencies [](#dependencies) Library requires CURL extension and PHP 7.0 or above. The recommended way to install this library is via [Composer](https://getcomposer.org). [New to Composer?](https://getcomposer.org/doc/00-intro.md) ``` composer require seregazhuk/pinterest-bot ``` Quick Start ----------- [](#quick-start) ``` // You may need to amend this path to locate Composer's autoloader require('vendor/autoload.php'); 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](#pagination) object with Pinterest API results is returned. How to avoid ban ---------------- [](#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. Examples -------- [](#examples) These articles provide examples of common tasks that can be performed with the bot: - [Automate pinning](http://seregazhuk.github.io/2017/03/25/build-pinterest-bot-with-php-auto-pin/) ([source code](examples/auto_pins.php)) - [Multiple Accounts and Proxy](http://seregazhuk.github.io/2017/03/28/build-printerest-bot-with-php-multiple-accounts/) ([source code](examples/multiple_accounts_and_proxy.php)) - [Comments, Likes And Repins](http://seregazhuk.github.io/2017/03/30/build-pinterest-bot-with-php-comments-and-repins/) ([source code](examples/comments_likes_repins.php)) - [Followers](http://seregazhuk.github.io/2017/04/01/build-pinterest-bit-with-php-followers/) ([source code](examples/followers.php)) - [Parsing Pins](http://seregazhuk.github.io/2017/04/04/build-pinterest-bot-with-php-parsing-pins/) ([source code](examples/pins_parser.php)) How can I thank you? -------------------- [](#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](https://camo.githubusercontent.com/211dae6c917cff3e611371d9fb804fc9927acec076ae57aef46edd0b6f32d1aa/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f6e6174652d70617970616c2d6f72616e67652e737667)](https://www.paypal.me/seregazhuk) Thanks! ### Health Score 36 — LowBetter than 81% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity19 Limited adoption so far Community14 Small or concentrated contributor base Maturity76 Established project with proven stability Bus Factor1 Top contributor holds 96.9% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~15 days Recently: every ~245 days Total 138 Last Release 1857d ago Major Versions 0.8.3 → 1.0.02015-12-30 1.0.1 → 2.0.02016-01-15 2.6.0 → 3.0.02016-05-29 3.3.1 → 4.0.02016-06-12 4.13.3 → 5.0.02016-11-08 PHP version history (7 changes)v0.1PHP >=5.3.0 v0.2PHP >=5.4.0 v0.4PHP >=5.5.0 2.4.2PHP >=5.6.0 4.2.2PHP >=5.5.9 5.5.1PHP >=5.6 5.8.0PHP >=7.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/067384af5d03f09088c686e43db1171800800a54fc6e0103d095cd5eb0c167a1?d=identicon)[mjphaynes](/maintainers/mjphaynes) --- Top Contributors [![seregazhuk](https://avatars.githubusercontent.com/u/9959761?v=4)](https://github.com/seregazhuk "seregazhuk (1461 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (33 commits)")[![AlexeyKosov](https://avatars.githubusercontent.com/u/8222004?v=4)](https://github.com/AlexeyKosov "AlexeyKosov (3 commits)")[![bercium](https://avatars.githubusercontent.com/u/909988?v=4)](https://github.com/bercium "bercium (2 commits)")[![kitar](https://avatars.githubusercontent.com/u/157844?v=4)](https://github.com/kitar "kitar (2 commits)")[![lex111](https://avatars.githubusercontent.com/u/4408379?v=4)](https://github.com/lex111 "lex111 (1 commits)")[![mjphaynes](https://avatars.githubusercontent.com/u/697891?v=4)](https://github.com/mjphaynes "mjphaynes (1 commits)")[![raiyaj](https://avatars.githubusercontent.com/u/21148709?v=4)](https://github.com/raiyaj "raiyaj (1 commits)")[![saulacher](https://avatars.githubusercontent.com/u/17094163?v=4)](https://github.com/saulacher "saulacher (1 commits)")[![andreybolonin](https://avatars.githubusercontent.com/u/2576509?v=4)](https://github.com/andreybolonin "andreybolonin (1 commits)")[![kiwired](https://avatars.githubusercontent.com/u/5903013?v=4)](https://github.com/kiwired "kiwired (1 commits)") --- Tags phppinterestlib ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/mjphaynes-pinterest-bot/health.svg) ``` [![Health](https://phpackages.com/badges/mjphaynes-pinterest-bot/health.svg)](https://phpackages.com/packages/mjphaynes-pinterest-bot) ``` ### Alternatives [niiknow/bayes a machine learning lib 6950.0k](/packages/niiknow-bayes)[imanghafoori/laravel-anypass A minimal yet powerful package to help you in development. 21421.6k](/packages/imanghafoori-laravel-anypass) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)