Documentation Index
Fetch the complete documentation index at: https://www.integrate.io/docs/llms.txt
Use this file to discover all available pages before exploring further.
| Description | Pinterest is a visual discovery platform where users find and save ideas. The Pinterest Ads API provides access to ad accounts, campaigns, pins, boards, and performance analytics. |
| Supported Replication | Initial Sync, Continuous Sync |
| Authentication Type | OAuth |
Collections
| Collection Name | Full/Initial Sync | Incremental/Continuous Sync | Supports Update | Supports Delete | Notes |
|---|---|---|---|---|---|
| Ad accounts | ✔ | ✖ | ✔ | ✖ | |
| Campaigns | ✔ | ✔ | ✔ | ✖ | |
| Ad groups | ✔ | ✔ | ✔ | ✖ | |
| Ads | ✔ | ✔ | ✔ | ✖ | |
| Boards | ✔ | ✖ | ✔ | ✖ | |
| Pins | ✔ | ✖ | ✔ | ✖ | |
| Ad analytics | ✔ | ✔ | ✖ | ✖ | Daily granularity |
| Campaign analytics | ✔ | ✔ | ✖ | ✖ | Daily granularity |
Setting up Pinterest for ELT & CDC
ELT & CDC uses the API provided by Pinterest to sync the data.Pinterest API Reference
Requirements
- A Pinterest Business account.
- At least one ad account linked to your Pinterest Business profile.
- You need to authenticate via OAuth2.
Setup Steps
Connect your Pinterest account
In Integrate.io, go to the ELT & CDC Sources page and select Pinterest. Click Sign In to authenticate via OAuth2 with your Pinterest Business account.
Select your ad account
After authentication, select the Pinterest ad account you want to replicate data from. If you manage multiple ad accounts, choose the one that contains the campaigns and analytics you need.
Choose collections
Select which collections (campaigns, ads, boards, pins, analytics) you want to sync to your destination.
Limitations
- Analytics lookback window: Pinterest analytics data can be retroactively adjusted for up to 30 days. If you need fully settled metrics, account for this window in your reporting.
- Rate limits: The Pinterest API enforces rate limits per ad account. Large accounts with many campaigns may experience slower sync times during the initial load.
- Organic vs. paid data: The ads, campaigns, ad groups, and analytics collections cover paid (advertising) data only. Boards and pins include both organic and promoted content.