List
Read live records straight from the Pinterest API.
- Source
- Marketing Analytics
- Generally available
- 14 entities
Move Pinterest data anywhere it matters.
Pinterest Ads is a platform that allows businesses to promote their products and services to a highly engaged audience on Pinterest. With over 400 million monthly active users, Pinterest is a visual discovery engine that helps people find inspiration and ideas for their interests and hobbies. Pinterest Ads allows businesses to create and display ads in the form of Promoted Pins, Promoted Video Pins, and Promoted Carousel Pins. These ads can be targeted to specific audiences based on their interests, behaviors, and demographics. Pinterest Ads also provides analytics and insights to help businesses measure the performance of their ads and optimize their campaigns for better results.
Source
Snowflake
BigQuery
Postgres
Databricks
Claude
- Streams
- 32
- Entities
- 14
- Actions
- 3
- Destinations
- 50+
- Certified support
- 2.3.6
Overview
What is the Airbyte Pinterest connector?
The Airbyte Pinterest connector extracts data from Pinterest and loads it into 50+ destinations such as Snowflake, BigQuery, Databricks or Postgres, with full refresh and incremental sync. It publishes 32 streams you can select per connection.
- 01
Sync to your warehouse
Land 32 Pinterest tables in 50+ destinations on a schedule you control.
- 02
Context store search
Query synced Pinterest data with filters, sorting and semantic search, without spending Pinterest API rate limits.
- 03
Incremental syncs
Pull only the records that changed since the last run instead of reloading everything.
- 04
Cloud or self-hosted
Run the Pinterest connector on Cloud, OSS, Hybrid.
32 streams
Every table you can sync from Pinterest
Account analytics Sync modes FullIncr. Boards Sync modes FullIncr. Board sections Sync modes FullIncr. Pins on board section Sync modes FullIncr. Pins on board Sync modes FullIncr. Ad accounts Sync modes FullIncr.
Setup
Live in eight steps
Open the Airbyte platform and navigate to the "Sources" tab on the left-hand side of the screen.
Click on the "Add Source" button and select "Pinterest Ads" from the list of available connectors.
Enter a name for the connector and click "Next".
Enter your Pinterest Ads credentials, including your username and password.
Click "Test Connection" to ensure that the credentials are correct and the connection is successful.
Once the connection is successful, select the data you want to sync from Pinterest Ads.
Choose the frequency of data syncing and the destination where you want to store the data.
Click "Create Source" to complete the process and start syncing data from Pinterest Ads to your chosen destination.
Configuration fields
| Field | Type | Description |
|---|---|---|
| account_id | string | The Pinterest account ID you want to fetch data for. This ID must be provided to filter the data for a specific account. |
| credentials | object | Not documented. |
| custom_reports | array | A list which contains ad statistics entries, each entry must have a name and can contains fields, breakdowns or action_breakdowns. Click on "add" to fill this field. |
| num_workers | integer | The number of worker threads to use for the sync. Higher values can speed up syncs but may increase rate-limit pressure against Pinterest. |
| start_date | string | A date in the format YYYY-MM-DD. If you have not set a date, it would be defaulted to latest allowed date by api (89 days from today). |
| status | array | For the ads, ad_groups, and campaigns streams, specifying a status will filter out records that do not match the specified ones. If a status is not specified, the source will default to records with a status of either ACTIVE or PAUSED. |
3 actions
Supported Pinterest actions
Get
Fetcha single record by ID.Context Store Search
Query synced data with filters and sorting, with no API rate limits.
Full parameter-level details live in the Pinterest entity reference.
Hybrid deployment
Sovereign by architecture, not by policy.
The data plane runs in your environment. Records, credentials and keys stay with you; the control plane only receives configuration and job metadata.
- Cloud
- OSS
- Hybrid
Your environment
Airbyte control plane
Use cases
What teams build with Pinterest
List all my Pinterest ad accounts
List all my Pinterest boards
Show me all campaigns in my ad account
List all ads in my ad account
Show me all ad groups in my ad account
List all audiences for my ad account
Show me my catalog feeds
Which campaigns are currently active?
What are the top boards by pin count?
Show me ads that have been rejected
Find campaigns with the highest daily spend cap
Related connectors
FAQ
Pinterest connector questions
Do I need more than one Pinterest connection?
No. One Pinterest authorization powers both the scheduled syncs that land data in your destination and the entity actions your agents call at runtime.
Do Pinterest entity actions need a sync to run first?
No. Entity actions read and write through the Pinterest API as they are called, so they work immediately. Context store search is the exception: it queries data Airbyte has already synced, which is what lets it filter and sort without spending API rate limits.
What data can I sync from Pinterest with Airbyte?
32 streams, including Account analytics, Boards, Board sections, Pins on board section, Pins on board, Ad accounts, Ad account analytics, Campaigns and more.
Does the Pinterest connector support incremental sync?
Yes. The Pinterest connector supports incremental sync on selected streams, and full refresh on every stream.
Where can I run the Pinterest connector?
Run the Pinterest connector on Cloud, OSS, Hybrid. Hybrid deployments keep the data plane in your environment while the control plane orchestrates syncs.
Didn't find your answer? Talk to sales
Start syncing Pinterest in minutes.
Free 14-day trial. One connection powers your scheduled syncs and your live Pinterest actions.