I build PinBoostr, a Pinterest scheduler for bloggers. The hard part was never calling Pinterest's API. It was deciding how many pins to send, when , and when to back off . A scheduler that posts too fast looks like a bot; one that panics and posts too little starves the account.
Here are the rules we ended up with, the bugs that taught us each one, and the numbers we use. Everything below runs in plain PHP on a cron-style tick, with a small Node worker doing the actual API calls.
Rule 1: never jump, climb at most +2 a day
A new account, or one coming back from a pause, ramps up slowly. The daily target can rise by at most 2 per calendar day .
Our first version applied "+2" per call. The volume function runs every minute, so an account could climb from 4 to 10 pins a day in a single afternoon. The fix was to measure from where the day started, not from the last call:
// The +2 step is per calendar day: measured from where today started, not from the last call.…