Pinterest Enterprise Connector
Intro
Pinterest is a social network that allows users to visually share and discover new interests. With the Pinterest Enterprise connector, you can check out Pinterest data including followers, following, pins, and many other Pinterest entities. To learn more about the Pinterest API, visit their page (https://developers.pinterest.com/).
You connect to your Pinterest account in the Data Center. This topic discusses the fields and menus that are specific to the Pinterest connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.
Prerequisites
To connect to your Pinterest account and create a DataSet, you must have the following:
-
A Pinterest client ID
-
A Pinterest client secret
-
Credentials for the Pinterest account (the email address you use to log into Pinterest and your Pinterest password) OR Facebook or Google credentials.
For the Redirect URI for the client ID and client secret, enter https://oauth.domo.com/api/data/v1/oauth/providers/pinterest-enterprise/exchange.
To learn how to generate a client ID and client secret, go here: https://www.codeholic.in/how-to-gene...nd-secret-key/.
Connecting to Your Pinterest Account
This section enumerates the options in the Credentials and Details panes in the Pinterest Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.
Credentials Pane
This pane contains fields for entering credentials to connect to your Pinterest account. The following table describes what is needed for each field:
Field |
Description |
---|---|
Client ID |
Enter your Pinterest client ID. |
Client Secret |
Enter your Pinterest client secret. |
To learn how to generate a client ID and client secret, go here: https://www.codeholic.in/how-to-gene...nd-secret-key/.
Once you have entered valid Pinterest credentials, you can use the same account any time you go to create a new Pinterest DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.
Details Pane
This pane contains a primary Reports menu, along with various other menus which may or may not appear depending on the report type you select.
Menu |
Description |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Report |
Select the Pinterest report you want to run. The following reports are available:
|
||||||||||||||||||||
Board ID |
Enter the ID of the board you want to pull data for. You can find boards IDs by running the "Boards" report and looking at the column called "Data Id Str." |
||||||||||||||||||||
Query (Optional) |
Lets you enter a query keyword when using the "Search Boards" and "Search Pins" reports. |
||||||||||||||||||||
Duration |
Select whether you want to pull data for a specific date or a date range. |
||||||||||||||||||||
Report Date |
Select whether the report data is for a specific date or for a relative number of days back from today. |
||||||||||||||||||||
Select Specific Date |
Select the date for the report. |
||||||||||||||||||||
Days Back |
Enter the number of past days that should appear in the report. |
||||||||||||||||||||
Start Date |
Specify whether the first date in your date range is a specific or relative date. You select the last date in your range in End Date. |
||||||||||||||||||||
End Date |
Specify whether the second date in your date range is a specific or relative date. You select the first date in your range in Start Date. |
||||||||||||||||||||
Select Specific Start Date |
Select the first date in your date range. |
||||||||||||||||||||
Select Specific End Date |
Select the second date in your date range. |
||||||||||||||||||||
Days Back to Start From |
Enter the number of the farthest day back that should be represented in the report. Combine with Days Back to End At to create a range of represented days. For example, if you entered 10 for Days Back to Start From and 5 for Days Back to End At, the report would contain data for 10 days ago up until 5 days ago. |
||||||||||||||||||||
Days Back to End At |
Enter the number of the most recent day back that should be represented in the report. Combine with Days Back to Start From to create a range of represented days. For example, if you entered 10 for Days Back to Start From and 5 for Days Back to End At, the report would contain data for 10 days ago up until 5 days ago. |
Other Panes
For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.
FAQs
How do I know my Pinterest credentials are secure?
Domo uses the OAuth process to connect to Pinterest, so your credentials are secure and are never saved. You can revoke Domo's access to your Pinterest account at any time.
Where can I find a Board ID?
You can find boards IDs by running the "Boards" report and looking at the column called "Data Id Str."
How often can the data be updated?
DataSets should be set to update once a day.
Are there any API rate limits I should be aware of?
Pinterest allows each user to make up to 1000 API calls per hour. Note that a single DataSet run may require multiple API calls. The 60-minute window is a sliding window based on when you make your first request. If you hit your rate limit, you’ll only have to wait a maximum of 1 hour to get a few more requests.
What happened to the Pins that I liked?
In June 2017, Pinterest removed the Like button from their UI., having concluded that the differences between the Like button and the Save button were confusing to users. Now they just have the Save button. All of the items that you had marked as "Liked" prior to that time were moved to a private board in your account called "Your Pinterest Likes."