* Set start_date dynamically based on API restrictions for lookup * Update changelog and bump connector version * Parse start_date from config * auto-bump connector version [ci skip] Co-authored-by: Octavia Squidington III <octavia-squidington-iii@users.noreply.github.com>
5.5 KiB
This page contains the setup guide and reference information for the Pinterest source connector.
Prerequisites
Please read How to get your credentials.
Setup guide
Step 1: Set up the Pinterest connector in Airbyte
For Airbyte Cloud:
- Log into your Airbyte Cloud account.
- In the left navigation bar, click Sources. In the top-right corner, click +new source.
- On the Set up the source page, enter the name for the Pinterest connector and select Pinterest from the Source type dropdown.
- Enter the
start_dateyou want your sync to start from.start_dateshould be no older than 914 days from today, that's the restriction of the Pinterest API for some of the streams. - Choose
OAuth2.0inAuthorization Methodlist - Click on
Authenticate your Pinterest accountbutton - Proceed with OAuth authentication of your account in the pop-up window that appears after previous step
- Click Set up source
For Airbyte OSS:
-
Navigate to the Airbyte Open Source dashboard
-
Set the name for your source
-
Enter your
client_id -
Enter your
client_secret -
Enter your
refresh_token -
Enter the
start_dateyou want your sync to start from.start_dateshould be no older than 914 days from today, that's the restriction of the Pinterest API for some of the streams. -
Choose
OAuth2.0inAuthorization Methodlist -
Click Set up source
Supported sync modes
The Pinterest source connector supports the following sync modes:
| Feature | Supported? |
|---|---|
| Full Refresh Sync | Yes |
| Incremental - Append Sync | Yes |
| SSL connection | Yes |
| Namespaces | No |
Supported Streams
- Account analytics (Incremental)
- Boards (Full table)
- Board sections (Full table)
- Pins on board section (Full table)
- Pins on board (Full table)
- Board sections (Full table)
- Ad accounts (Full table)
- Ad account analytics (Incremental)
- Campaigns (Incremental)
- Campaign analytics (Incremental)
- Ad groups (Incremental)
- Ad group analytics (Incremental)
- Ads (Incremental)
- Ad analytics (Incremental)
Performance considerations
The connector is restricted by normal Pinterest requests limitation.
Rate Limits
Analytics streams - 300 calls per day / per user
Ad accounts streams (Campaigns, Ad groups, Ads) - 1000 calls per min / per user / per app
Boards streams - 10 calls per sec / per user / per app
Changelog
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.1.7 | 2022-09-29 | 17387 | Set start_date dynamically based on API restrictions. |
| 0.1.6 | 2022-09-28 | 17304 | Use CDK 0.1.89 |
| 0.1.5 | 2022-09-16 | 16799 | Migrate to per-stream state |
| 0.1.4 | 2022-09-06 | 16161 | Added ability to handle 429 - Too Many Requests error with respect to Max Rate Limit Exceeded Error |
| 0.1.3 | 2022-09-02 | 16271 | Added support of OAuth2.0 authentication method |
| 0.1.2 | 2021-12-22 | 10223 | Fix naming of AD_ID and AD_ACCOUNT_ID fields |
| 0.1.1 | 2021-12-22 | 9043 | Update connector fields title/description |
| 0.1.0 | 2021-10-29 | 7493 | Release Pinterest CDK Connector |