Finally (!) Pinterest has joined the rest of the social media platforms in offering an (almost public*) API. The launch was made with 20 partners including a few popular ecommerce brands like Wal-Mart, Target, ModCloth and more.
There are five different domain endpoints.
(1) Most Recent Pins: exactly what the name describes – this API endpoint allows you to fetch your most recent pins from your website. Pinners can see the latest Pins from your site wherever you decide to display them.
(2) Related Pins: similar to the idea of related products, this endpoint lets you display Pins from your website that are similar to a Pin you choose. You specify “Pin A” and the API will return Pins B, C, D, etc. from your site.
(3) Top Repins per Domain: this API allows you to display a collection of the most repinned Pins from your website over a certain period of time (daily, weekly or bi-weekly). If you were to choose daily repin values, the API returns the most repinned Pins for the past day. This endpoint is bookmarked and each bookmark returns up to 100 Pins.
(4) Top Repins Domain: similar to the above API, this endpoint returns a collection of pins based on your time values (daily, weekly or bi-weekly). If you were to choose daily type with a daily aggregation value, the API returns the most repinned Pins for the past day.
(5) Domain Search: this API allows you to see Pins from your website that include specific search terms. You specify a search predicate and the API will show Pins with that term in the description.
Websites & Pinterest Integration Examples
Target is using a little bit of a different approach by featuring top pinned items in their Home Decor category. Instead of creating a full page for the top Pins, they feature a widget on the Home Decor category page. It also appears like they’re using the Related Pins endpoint as well.
A couple things all these websites have in common:
- All of the websites are either product, recipe or article focused which aligns with their Rich Pins mark-up types.
- All sites include a “Follow us on Pinterest” Call-To-Action.
- Ability to users to Pin items directly from widget/page.
- Items all are “Rich Pins.“
Do you plan on adopting the Pinterest API? How would you integrate the different endpoints with your website?
*The API isn’t available to the public, just yet. You still have to request access and describe your intentions with using the different endpoints. You can request access, here.