README

basic bindings for Pinterest API v3.

This is an unofficial API, and likely to change and break at any moment.

==

You'll need an access token to make API calls. This is accomplished with an XAuth-like call using HTTP Basic Auth over SSL.

$p = new PinterestAPI();
$p->fetch_access_token($client_id, $client_secret, $username, $password);
$resp = $p->some_api_call($args);

See the demo example/index.php to try.

Alternately if you already have an access token

$p = new Pinterest_API($access_token);
$p->some_api_call($args);

==

The only methods I know about are:

• upload_pin
• repin
• boards
• activity
• popular

Notably missing is a pin method that simulates the pinmarklet. (that said I haven't looked very hard, so if you find one, let me know)

==

At the moment the upload_pin method only takes the funny curl style file descriptors. It would be straightforward to make it smarter, but I haven't need it for my script. Call it like so

$resp = $p->upload_pin(array(
    'board' => $board_id,
    'details' => 'another test',
    'image' => "@".realpath('../img/37.jpg')
 ));