DKS Blog. Your guide to web design, development, and internet marketing.

Pinterest Announces API Endpoints

11/19/13 – 5:44 am | Posted By: Courtney Petty

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.

Pinterest is calling it “Domain API endpoints.” The endpoints are only available to domains that have been verified (through business accounts).

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

Toms shoes created a special feature category for Top Pinterest Pins (only in the women’s shopping section) where they pull in the most popular pins of the week.

Modcloth has a category for “Most Pinned Pieces” where they feature popular Pins (updated daily).

Even Whole Foods Market has a Pinterest category, featuring recipe pins and infographics.

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.

About the Author: Courtney Petty

Courtney Petty
Courtney is the Web Marketing Specialist for DKS Systems. She specializes in all things related to online marketing such as Search Engine Optimization (SEO), social media, paid advertising and more. Outside hobbies include cooking, crafts and shopping online.

Related Posts


Post a comment or leave a trackback: Trackback URL.

One Trackback

  1. [...] Courtney Petty It seems like all I do is talk about Pinterest, lately. But with new releases like API Endpoints and Place Pins, how can I [...]

Post a Comment

Your email is never shared.