Due to Pinterest upgrading its reporting data API, Supermetrics is releasing a new and improved version of the Pinterest Organic data source connector. In this article, we highlight the similarities and differences between our old and new Pinterest Organic data source connectors and how to start using the new connector.
All Supermetrics users who have Pinterest Organic in their license will automatically get access to the new connector.
What's happening
- On June 1, 2023, the old connector is renamed to "Pinterest Organic (legacy)" and will stop gathering data after June 30, 2023.
- On June 1, 2023, a new connector named "Pinterest Organic" is made available to replace the old one.
Feature overview
| Pinterest Organic (legacy) | Pinterest Organic |
|---|
Authentication and data access - Fetch organic data for pins that your Pinterest profile owns.
Query types - Profile lifetime metrics
- Profile data
- Top pins
- Profile pins
- Profile boards
| Authentication and data access - Fetch organic data for pins that your Pinterest profile owns.
- NEW! Fetch organic data for other Pinterest profiles where you have Partner or Employee access.
Query types - Profile.
Combines the Profile lifetime metrics and Profile data query types from Pinterest Organic (legacy). - Top pins
- NEW! Owned pins.
Fetch organic engagement metrics for all of your owned pins and break down metrics to a daily level per pin.
Profile pins and Profile boards query types are not available. |
What you need to do
The features of the new data source connector closely match those of the old one. However, due to major changes in the underlying reporting API of Pinterest, you need to create a connection to Pinterest with the new connector.
To recreate your existing queries, follow the steps in the linked article for your Supermetrics product and refer to the query type comparison below to find the matching query types in the new connector.
Google Sheets
Microsoft Excel
Looker Studio
Data warehouse and cloud storage
Authentication
| Pinterest Organic (legacy) | Pinterest Organic |
|---|
Prerequisites - Pinterest business profile
Data permissions
- See all of your boards (including secret boards and group boards you join)
- Create new Pins and boards for you
| Prerequisites - Pinterest business profile
- Pinterest ad account connected (no ad campaigns or spending required)
Data permissions - See all of your advertising data, including ads, ad groups, campaigns, and so on
- See your public boards, including group boards you join
- See your public Pins
- See your user accounts and followers
|
Query types comparison
| Pinterest Organic (legacy) | Pinterest Organic |
|---|
Profile lifetime metrics - Get lifetime metrics of the Pinterest profile.
| Profile - Get lifetime metrics of the Pinterest profile.
- Get aggregated metrics of all pins.
- Only returns organic data.
- Returns data from all sources (Your pins and Other pins).
|
Profile data - Get aggregated metrics of all pins.
- Filter data by Pin type and Pin source.
|
Top pins - Get metrics for the top 50 pins.
- Filter data by Pin type and Pin source.
| Top pins - Get metrics for the top 50 pins.
- Only returns organic data.
- Always returns data from all sources (Your pins and Other pins). Include the “Is owner” dimension in your queries to distinguish between your own pins and other pins.
- NEW! Closeups and closeup rate metrics added.
- NEW! Video engagement metrics added
- Video Views
- 10-second plays
- Played to 95%
- Average video play time
- Total play time (minutes)
- Video starts
- Full screen play
- Full screen playtime
Comments and Repins metrics are not available. |
Profile pins - Get lifetime metrics for all pins (comments, likes, repins).
| Not available. |
Profile boards - List all boards on the account (number of pins, collaborators, followers).
| Not available. |
| Not available. | NEW! Owned pins - Fetch organic engagement metrics for all of your owned pins and break down metrics to a daily level per pin.
Metrics available: - Impressions
- Pin clicks
- Pin click rate
- Outbound clicks
- Outbound click rate
- Saves
- Save rate
- Video Views
- 10-second plays
- Played to 95%
- Average video play time
- Total play time (minutes)
- Video starts
This query type is currently not available in Looker Studio. |