seregazhuk/php-pinterest-bot
Stars: 412
Forks: 151
Pull Requests: 294
Issues: 229
Watchers: 48
Last Updated: 2020-05-29 10:30:02
This PHP library will help you to work with your Pinterest account without using any API account credentials.
License: MIT License
Languages: PHP
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
- Boards
- Pins
- Pinners
- Interests and topics
- Search
- Inbox
- Keywords
- Error handling
- Use proxy
- Custom request settings
- Cookies
- Pagination
Installation
Dependencies
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
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 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.
Examples
These articles provide examples of common tasks that can be performed with the bot:
- Automate pinning (source code)
- Multiple Accounts and Proxy (source code)
- Comments, Likes And Repins (source code)
- Followers (source code)
- Parsing Pins (source code)
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:
Thanks!
OPEN ISSUES
See all- Add recommended searches by @seregazhuk
- Extract Request from the provider state by @seregazhuk
- Enhancement: Get Pins of Section by @delemore
- Video Pins by @darkknight68
- Keyword Results Query by @honest76
- Comments get list don't show by @nscyber
- How to resend verification email by @BurakBoz
- if board exist return board id else create function by @oguzdelioglu
- Can not create an account by @yildiz
- Calling the RecommendedFor many times ended with no result by @exiost
- ask about auth logout() by @Iquaridys
- Creating Pin Issue by @kaankilic
- Same pins are re-pinning with search. by @ahmed-alii
- "$pinBot->boards->forMe();" Does't work by @Hasokeyk
- API changed on Pinner Search! by @kaankilic
- Ask me to reset password always (proxy) by @pauznet
- Create APP and Get Token by @oguzdelioglu
- Problem to create a new pin by @xuseit
- [Invalid email.] When Registering Pinterest by @oguzdelioglu
- Registration error: Invalid parameters. by @mtnyvz16
- account banned by @thearthouse
- how can be scheduled images to go live at a later date on pinterest using api in php? by @ponnnarasi14
- Domain Spam or Blocked Check? by @hcevikbas
- Error when create acc by @fhartavi
- Pinterest rate limits by @LinkTree3
- Get Boards Return Empty by @flameblue59
- Can you please help me to use the edit command ? by @gonjumixproject
- Your requirements could not be resolved to an installable set of packages. by @AJMALSARIM
- Autoloader issue by @balubalubalu
- Login method not working by @policemal
- Is this project dead? Cannot connect Pinterest Account. by @dmoney1908
RELEASES
See all- 0.1 by @seregazhuk
- 0.2 by @seregazhuk
- 0.3 by @seregazhuk
- 0.4 by @seregazhuk
- 0.5 by @seregazhuk
- 0.5.1 by @seregazhuk
- 0.6 by @seregazhuk
- 0.7 by @seregazhuk
- 0.7.1 by @seregazhuk
- by @seregazhuk
- 0.8 by @seregazhuk
- Change in Pinterest base API url by @seregazhuk
- Fixes with auto-login by cookie by @seregazhuk
- Edit pin by @seregazhuk
- Refactoring by @seregazhuk
- Providers refactoring by @seregazhuk
- Changes in generators behavior by @seregazhuk
- Registration add by @seregazhuk
- Business accounts support by @seregazhuk
- Cookies and auto login by @seregazhuk
- 5.3.0 by @seregazhuk
- 5.3.1 by @seregazhuk
- 5.3.2 by @seregazhuk
- 5.3.3 by @seregazhuk
- 5.3.4 by @seregazhuk
- 5.3.5 by @seregazhuk
- 5.3.6 by @seregazhuk
- 5.3.7 by @seregazhuk
- 5.3.9 by @seregazhuk
- v5.9.1 by @seregazhuk
- v5.9.0 by @seregazhuk
- 5.8.0 by @seregazhuk
- 5.7.3 by @seregazhuk
- 5.7.2 by @seregazhuk
- 5.7.1 by @seregazhuk
- 5.7.0 by @seregazhuk
- 5.6.9 by @seregazhuk
- 5.6.8 by @seregazhuk
- 5.6.7 by @seregazhuk
- 5.6.4 by @seregazhuk
- 5.6.3 by @seregazhuk
- 5.6.1 by @seregazhuk
- 5.6.0 by @seregazhuk
- 5.5.6 by @seregazhuk
- 5.5.5 by @seregazhuk
- 5.5.4 by @seregazhuk
- 5.5.2 by @seregazhuk
- 5.4.4 by @seregazhuk
- 5.4.2 by @seregazhuk
- 5.4.0 by @seregazhuk
- 5.3.11 by @seregazhuk
- 5.3.10 by @seregazhuk