> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/ppc/pinterest-ads.md).

# Pinterest Ads

Export Pinterest Ads campaigns, ad groups, and promoted pins to Google Sheets, BigQuery, or AI tools with Coupler.io.

Pinterest Ads is Pinterest's advertising platform that helps you promote pins, products, and drive traffic to your website. With Coupler.io, you can automatically export your Pinterest Ads performance data—campaigns, ad groups, promoted pins, keywords, and more—to Google Sheets, Excel, BigQuery, Looker Studio, or AI destinations like Claude and ChatGPT.

## Why connect Pinterest Ads to Coupler.io?

* **Automate reporting** — Pull campaign performance, conversions, and spend data on a schedule without manual exports
* **Multi-account management** — Combine data from multiple ad accounts in one place for unified analysis
* **Flexible granularity** — Choose report types ranging from account-level summaries to individual promoted pin performance
* **Conversion attribution** — Customize conversion windows and attribution models (click, engagement, view) to match your business
* **Real-time analysis** — Feed data into BI tools like Looker Studio or send insights directly to AI models for pattern detection

## Prerequisites

* A Pinterest Business or Ads Manager account with at least one active ad account
* Access to grant Coupler.io permission to read your ad account data via OAuth
* Destination account (Google Sheets, Excel, BigQuery, Looker Studio, or an AI destination)

## Quick start

{% hint style="success" %}
Start with a **Campaign performance** report for your primary ad account, split by **Daily** to track spend and conversions over time. Once you've validated the data, expand to other report types like ad groups or keywords.
{% endhint %}

## How to connect

{% stepper %}
{% step %}
**Click "Add source"** and select **Pinterest Ads**.
{% endstep %}

{% step %}
**Authorize your Pinterest account.** You'll be redirected to Pinterest's login. Sign in and approve Coupler.io's access to read your ad account data.
{% endstep %}

{% step %}
**Select a report type.** Choose from performance reports (campaign, ad group, promoted pin, account, product group, keywords, etc.) or list reports (accounts, campaigns, ad groups, ads, keywords). Performance reports include metrics like spend, impressions, clicks, and conversions. List reports show your account structure without metrics.
{% endstep %}

{% step %}
**If you selected a performance report:** Choose your **ad accounts** (if you have multiple), then set a **start date** and **end date** for the reporting period. You can use date macros like `{{today}}` or `{{30daysago}}` for dynamic ranges.
{% endstep %}

{% step %}
**Select metrics.** Pinterest offers hundreds of metrics across conversion types (checkout, add to cart, signup, etc.), attribution models (web, in-app, offline), and engagement types (clicks, impressions, video plays, etc.). Pick the ones most relevant to your business.
{% endstep %}

{% step %}
**Configure conversion settings.** Choose whether conversions are reported by **time of ad action** (default) or **time of conversion**, and select a **conversion window** (how many days after a click, engagement, or view counts as a conversion). Default is 30/1/1 (30 days post-click, 1 day post-engagement, 1 day post-view).
{% endstep %}

{% step %}
**For targeting analysis reports only:** Select a **dimension** (age bucket, gender, location, device, placement, keyword, interest, etc.) to break down your metrics by audience or placement characteristics.
{% endstep %}

{% step %}
**Choose your destination.** Select where you want the data: Google Sheets, Excel, BigQuery, Looker Studio, or send to an AI destination (Claude, ChatGPT, Cursor, Gemini, Perplexity, OpenClaw) for automated analysis.
{% endstep %}

{% step %}
**Run the data flow manually** to verify the data looks correct before scheduling. Once you've confirmed the output, you can set up a schedule in the data flow settings.
{% endstep %}
{% endstepper %}

## Report types overview

| Report Type                   | Best For                         | Includes                                                             |
| ----------------------------- | -------------------------------- | -------------------------------------------------------------------- |
| Campaign performance          | High-level campaign metrics      | Campaign name, spend, impressions, clicks, conversions               |
| Ad group performance          | Ad group-level analysis          | Ad group, campaign, spend, CTR, conversions by type                  |
| Ad (promoted pin) performance | Individual pin performance       | Pin ID, creative, spend, engagement, saves, outbound clicks          |
| Ad account performance        | Account-level KPIs               | Total spend, impressions, reach, conversions across all campaigns    |
| Product group performance     | Product-level metrics (shopping) | Product group, order value, ROAS, quantity sold                      |
| Keywords performance          | Keyword bidding & ROI            | Keyword, search volume, CPC, conversions                             |
| Targeting analysis            | Audience insights by dimension   | Metrics segmented by age, location, device, placement, interest      |
| List reports                  | Account structure                | All campaigns, ad groups, ads, keywords in your account (no metrics) |

## Available report types

Pinterest Ads data flows support two categories of reports:

### Performance Reports

These include metrics like spend, impressions, clicks, conversions, and engagement. They can be split by time period (daily, weekly, monthly) and are available for campaigns, ad groups, promoted pins, accounts, product groups, keywords, and targeting dimensions.

### List Reports

These return the structure of your account—all campaigns, ad groups, ads, and keywords—without performance metrics. Useful for auditing or syncing your account structure to a spreadsheet.

***

## Available metrics

Pinterest offers hundreds of metrics across these main categories:

#### Conversion Metrics

Metrics are broken down by conversion type (Add to cart, Checkout, Signup, Lead, Page visit, Watch video, App install, Custom, Unknown) and attribution model (Web, In-app, Offline, Pinterest native).

* **Total conversions** — All attributed conversions
* **Conversion value** — Revenue or order value from conversions
* **Conversion rate** — Conversions as a percentage of interactions
* **CPA (Cost per acquisition)** — Spend divided by conversions
* **ROAS (Return on ad spend)** — Revenue divided by spend
* **Click-through conversions** — Conversions attributed to clicks (within your conversion window)
* **Engagement conversions** — Conversions attributed to pin engagements (saves, comments)
* **View-through conversions** — Conversions from users who saw the pin but didn't click

#### Engagement Metrics

* **Engagements** — Total pin interactions (clicks, saves, comments)
* **Paid engagements** — Engagements from your promoted pins
* **Earned engagements** — Organic engagements from your pins
* **Saves / Save rate** — Pin saves and rate
* **Outbound clicks** — Clicks to your website
* **Pin clicks** — Clicks on the pin itself

#### Reach & Impression Metrics

* **Impressions** — Number of times your ad was shown
* **Reach** — Unique users who saw your ad
* **Frequency** — Average impressions per user
* **CTR (Click-through rate)** — Clicks as a percentage of impressions

#### Cost Metrics

* **Spend** — Total ad spend
* **CPM (Cost per thousand impressions)**
* **CPC (Cost per click)**
* **CPE (Cost per engagement)**

#### Video Metrics (for video pins)

* **Video views** — Number of video plays
* **Video starts** — Initiated plays
* **3-second plays** — Plays lasting at least 3 seconds
* **Plays at 25/50/75/95/100%** — Video play-through at specific thresholds
* **Average watch time** — Mean seconds watched per play

#### Product & Shopping Metrics

* **Order value** — Revenue per order
* **Order quantity** — Number of items sold
* **Buyable Pin in-app checkouts** — Conversions from shoppable pins

#### Lead Metrics

* **Leads** — Form submissions or sign-ups
* **Cost per lead**

***

## Available dimensions (for targeting analysis)

When running a **targeting analysis** report, you can break down metrics by:

* **Age bucket** — 18-24, 25-34, 35-44, 45-54, 55-64, 65+
* **Gender** — Female, male, unspecified
* **Location** — City, metro, region, or country
* **Device** — Mobile, desktop, tablet
* **Placement** — Pinterest feed, search results, buyable pins, etc.
* **Keyword** — Search keywords that triggered your ads
* **Targeted interest** — Interests you're targeting
* **Pinner interest** — Interests of users who interacted with your pins

***

## Common metric combinations by goal

**E-commerce (ROAS-focused)**

* Spend
* Web conversions (Checkout)
* Web order value (Checkout)
* Web ROAS (Checkout)
* Impressions

**Lead generation**

* Spend
* Leads / Web conversions (Lead)
* Cost per lead / Web CPA (Lead)
* Impressions
* CTR

**Traffic & awareness**

* Spend
* Paid outbound clicks
* CPM / CPC
* Impressions
* Reach
* Frequency

**Video engagement**

* Video views
* Plays at 25/50/75/100%
* Average watch time
* CPV (Cost per video view)
* Impressions

**Audience insights**

* Run a **targeting analysis** report with **Location** or **Age bucket** dimension
* Include: Impressions, Engagements, Saves, Outbound clicks
* Segment by your chosen dimension to identify top-performing demographics

***

## Use cases by role

{% tabs %}
{% tab title="Performance Marketers" %}
Use Pinterest Ads data flows to monitor campaign efficiency and optimize spend:

* **Daily campaign reporting** — Pull campaign performance split by day to catch underperforming ads early
* **Multi-account consolidation** — Combine data from multiple ad accounts (if managing client accounts) using Append transformation
* **ROAS analysis** — Track Web ROAS (Checkout) by campaign to identify your most profitable initiatives
* **Audience insights** — Run targeting analysis by location and device to double-down on high-converting demographics
* **Feed to BI tools** — Send Coupler.io data to Looker Studio and create dynamic dashboards with date range controls
* **AI-powered optimization suggestions** — Send your Pinterest data to Claude or ChatGPT for automated performance analysis and recommendations
  {% endtab %}

{% tab title="Finance & Leadership" %}
Use Pinterest Ads data flows for budget tracking and ROI reporting:

* **Budget vs. spend** — Export account-level performance to track total ad spend against allocated budgets
* **Cross-channel ROI** — Combine Pinterest data with data from other channels (Facebook, Google Ads) using Append, then calculate blended ROAS
* **Monthly reporting** — Pull data split by month for clean P\&L summaries and stakeholder updates
* **Conversion attribution** — Customize conversion windows to match your sales cycle (e.g., 60-day post-click for B2B leads)
* **Periodic audits** — Export list reports (all campaigns, keywords) to compare Pinterest account structure against your master marketing calendar
  {% endtab %}

{% tab title="E-Commerce Managers" %}
Use Pinterest Ads data flows to drive sales and optimize product-level performance:

* **Product group performance** — Pull metrics by product group to identify which product lines drive the most ROAS
* **Checkout conversion tracking** — Include web conversions (Checkout), web order value, and web ROAS (Checkout) to measure revenue impact
* **Promoted pin audits** — Export list of ads (promoted pins) to see which creative has the highest engagement and conversion rates
* **Inventory correlation** — Join Pinterest conversion data with your product inventory or stock levels to optimize bidding on trending items
* **Seasonal trend analysis** — Pull daily data across peak seasons and compare spend vs. order value to plan future budget allocation
  {% endtab %}

{% tab title="Data Analysts" %}
Use Pinterest Ads data flows for deep analysis and modeling:

* **Attribution modeling** — Export data with multiple conversion windows (e.g., 7/7/7 and 30/30/30) and compare conversion patterns to optimize your window
* **Cohort analysis** — Pull daily data, segment by dimension (age, location), and analyze cohort behavior over time
* **Spend efficiency trends** — Calculate CPA and ROAS over rolling periods to identify inflection points where performance changes
* **Video engagement benchmarking** — Export video metrics (plays at 25/50/75%, avg watch time) and build models to predict view-through conversion rates
* **Data warehouse ingestion** — Send Pinterest data directly to BigQuery for long-term storage, transformation, and integration with other marketing data sources
  {% endtab %}
  {% endtabs %}

***

## Platform-specific notes

* **Conversion window formats** — Pinterest conversion windows are specified as three numbers: click window / engagement window / view window (e.g., 30/1/1 = 30 days post-click, 1 day post-engagement, 1 day post-view). Default is 30/1/1.
* **Attribution reporting** — Conversions can be reported by **time of ad action** (when the user saw or clicked your pin) or **time of conversion** (when the user completed the action). Choose based on whether you want to match campaign performance dates or conversion completion dates.
* **Conversion types** — Pinterest segments conversions by user action (Add to cart, Checkout, Signup, etc.) and tracks them across Web, In-app, Offline, and custom audiences. Select only the conversion types relevant to your business.
* **Targeting dimensions** — Targeting analysis reports let you slice metrics by audience (age, gender) or placement (device, feed vs. search). Use these to identify your highest-ROI audience segments.
* **Product group reporting** — Available only if you've set up Pinterest Shopping campaigns. Requires product catalog sync.
* **Keyword metrics** — Keywords are tracked for campaigns using keyword targeting or search campaigns. Metrics include search volume, CPC, and conversions.
* **Data latency** — Pinterest data is typically available with a 24–48 hour delay. Schedule data flows to run in the evening or early morning for the most complete daily data.
* **Multi-account data** — If you have multiple ad accounts, select them in the **Ad accounts** parameter. Coupler.io will pull data from each separately; use the Append transformation to combine results in a single sheet or table.

## Pinterest Ads common issues

### Connection issues

<details>

<summary>OAuth authorization fails or "Invalid credentials" error</summary>

Pinterest's OAuth session may have expired or your Pinterest account permissions may have changed.

**Fix:**

1. Disconnect the Pinterest Ads source from Coupler.io (go to Data sources, click the source, and select Disconnect).
2. Delete any existing data flows using Pinterest Ads.
3. Reconnect by creating a new data flow and signing in to your Pinterest Business account again.
4. Verify that your Pinterest account has **Ads Manager** or **Admin** access.
5. Ensure your ad account is not restricted or in violation of Pinterest's policies.

</details>

<details>

<summary>"Permission denied" when selecting ad accounts</summary>

Your Pinterest user account may not have access to the ad accounts you're trying to select, or your account role is too restricted.

**Fix:**

1. Log into your Pinterest Business account and go to **Ads Manager** → **Settings** → **Business Access**.
2. Verify that your user account has at least **Analyst** role (can view reports) on the ad accounts you want to pull data from.
3. If you just added a new ad account, wait 15–30 minutes for permissions to sync, then reconnect in Coupler.io.
4. Contact your Business Account Manager if you're still seeing restricted accounts.

</details>

<details>

<summary>"No data available" for selected ad account</summary>

The ad account may not have any campaigns, ads, or conversions during your selected date range.

**Fix:**

1. Verify the ad account is active and has running campaigns during your start/end date range.
2. Check the Pinterest Ads Manager directly to confirm data exists for the same date range.
3. If the account is brand new, campaigns may still be pending approval. Wait 24 hours and try again.
4. Try expanding your date range (e.g., from last 7 days to last 30 days) to ensure data exists.

</details>

### Missing data

<details>

<summary>Conversion metrics are zero or very low compared to Pinterest Ads Manager</summary>

Conversion data depends on your **conversion window** and **conversion report time** settings. If these don't match your Pinterest Ads Manager setup, reported conversions will differ.

**Fix:**

1. In your data flow, check the **Conversion window** setting. The default is 30/1/1 (30 days post-click, 1 day post-engagement, 1 day post-view). If your Ads Manager uses a different window (e.g., 7/7/1), change it to match.
2. Verify **Conversion report time** is set to the same option as in Ads Manager: either "Time of ad action" (default) or "Time of conversion".
3. Ensure you've selected the correct **conversion type** metrics (Web conversions, In-app conversions, etc.). If you're only pulling "Web conversions (Checkout)" but your traffic includes sign-ups, you'll miss those conversions.
4. Check that your selected **date range** includes the conversion window. For example, if you set "Time of conversion" and pull data for today with a 30-day conversion window, conversions from clicks 30 days ago appear today, but clicks from today won't convert for 30 days.

</details>

<details>

<summary>Some campaigns or ads are missing from the report</summary>

Campaigns or ads may be filtered out if they don't match the metrics or date range criteria.

**Fix:**

1. Verify that campaigns have metrics data during your selected date range. Paused campaigns with no impressions may not appear in performance reports.
2. Use a **List report** (e.g., "List of campaigns" or "List of ads") to see all campaigns/ads in your account regardless of performance.
3. Check if you've applied **additional filters** that may be excluding certain campaigns (e.g., filtering by minimum spend or impression thresholds).
4. Try expanding your date range to the last 90 days to confirm campaigns exist.

</details>

<details>

<summary>Engagement metrics (saves, outbound clicks) are missing or zero</summary>

Engagement metrics are only available for certain report types and content formats. Not all pins generate all engagement types.

**Fix:**

1. Confirm you've selected an engagement metric (Paid engagements, Saves, Outbound clicks, Pin clicks, etc.) in the **Metrics** parameter.
2. Check that your pins are not video-only (video pins may not generate all engagement types equally).
3. Use a different engagement metric (e.g., swap "Paid saves" for "Paid engagements") to see if data exists.
4. Verify pins are getting impressions. If a pin has 0 impressions, it will have 0 engagement.

</details>

### Permission errors

<details>

<summary>"Insufficient permissions" or "Access denied" error</summary>

Your Pinterest Ads Manager account role is too restricted, or you're trying to access an ad account you don't own.

**Fix:**

1. Contact the Business Account Owner or Admin and request at least **Analyst** or **Editor** role on the ad account.
2. Ask them to verify your user is added to **Business Access** in Ads Manager Settings.
3. If you manage client accounts via a brand partner program, ensure your brand account has been granted access to each client's ad account.
4. If you're a fresh team member, wait 15–30 minutes for role changes to propagate in Pinterest's system.

</details>

### Data discrepancies

<details>

<summary>Spend or metrics differ between Coupler.io and Pinterest Ads Manager</summary>

Data mismatches usually stem from **conversion window** settings, **timezone** differences, or **reporting time** misalignment.

**Fix:**

1. **Match conversion windows:** Open Pinterest Ads Manager, go to Settings, and check your default conversion window. Set the same window in Coupler.io (Conversion window parameter).
2. **Check conversion report time:** In Coupler.io, select "Time of ad action" (default) and verify this matches your Ads Manager setting.
3. **Verify date range:** Ensure your Coupler.io start/end dates match the report date range in Ads Manager. Note that data may shift if you change the conversion window.
4. **Check timezone:** Pinterest reports in your account's timezone. Verify Coupler.io's destination (e.g., Google Sheets) is not applying a different timezone.
5. **Wait for data finalization:** Pinterest's data can shift slightly within 24–48 hours as conversions are attributed. Compare reports from the same time yesterday for consistency.
6. **Pull raw data:** If using aggregated metrics (e.g., "Split data by month"), try pulling "Totals only" to see raw metrics without aggregation, then aggregate yourself.

</details>

<details>

<summary>Spend is accurate but conversions are significantly off</summary>

Conversion attribution settings (click, engagement, view window) or conversion type selection is likely the cause.

**Fix:**

1. In Coupler.io, check you've selected **all relevant conversion types** (Web, In-app, Offline, Custom). Don't just select one.
2. Verify your **conversion window** matches Pinterest's attribution model. A 30/30/30 window will report more conversions than a 7/1/1 window.
3. Check that "Time of conversion" is not selected if your Ads Manager uses "Time of ad action"—switching between these reporting times can shift which conversions appear.
4. In Pinterest Ads Manager, manually check a campaign's conversion metrics for the same date range. Note the exact numbers and match Coupler.io settings.
5. If mismatch persists, try pulling a **List report** (campaigns or ads) alongside a performance report to cross-reference which campaigns are included.

</details>

<details>

<summary>Data refreshed but numbers changed retroactively (yesterday's spend changed)</summary>

Pinterest recalculates conversions and engagement metrics as data arrives. This is normal, especially for view-through conversions and attribution windows.

**Fix:**

1. This is expected behavior—conversion data can shift within 24–48 hours as Pinterest's servers finalize attribution.
2. Use the **"Time of conversion"** report time setting if you need stable historical data, as it reports when the conversion actually occurred, not when Pinterest measured it.
3. If you're monitoring daily performance, compare the same day from 2+ days ago (e.g., today vs. two days ago) for stable numbers.
4. For financial reporting, pull data 2–3 days after the period ends to allow Pinterest time to finalize attribution.

</details>

### Rate limits

<details>

<summary>Data flow runs slowly or times out, especially with large date ranges or many metrics</summary>

Pinterest's API has rate limits. Large pulls (30+ metrics, 90+ day range, multiple ad accounts) may hit these limits.

**Fix:**

1. **Reduce metrics:** Select only the metrics you actually need. Each metric is a separate API call; 50 metrics = 50 calls. Aim for 10–20 metrics per flow.
2. **Shorten the date range:** Instead of pulling 90 days at once, pull the last 30 days and schedule daily refreshes. Coupler.io will keep a rolling window of recent data.
3. **Split by ad account:** If you have 5+ ad accounts, create separate data flows for each account, then use **Append** to combine in a final flow.
4. **Increase refresh interval:** If you're refreshing every hour, scale back to every 6 hours or daily. More frequent refreshes = more API calls.
5. **Use "Totals only":** Avoid splitting data by period (daily/weekly/monthly) on large reports. Pull totals and aggregate in your destination (e.g., Google Sheets pivot table) if needed.

</details>

<details>

<summary>"API quota exceeded" or "Too many requests" error during scheduled refresh</summary>

Your data flow is running at the same time as another job (e.g., another Coupler.io integration), or you have multiple flows pulling Pinterest data simultaneously.

**Fix:**

1. Stagger your data flow refresh times. If you have 3 Pinterest flows, schedule them 10 minutes apart instead of all at once.
2. Check if other team members are also running Pinterest data flows. Coordinate to avoid simultaneous pulls.
3. Temporarily pause non-critical data flows during peak hours.
4. Contact Coupler.io support if this persists; we can help optimize your flow architecture.

</details>

## Pinterest Ads FAQ

<details>

<summary>Can I combine Pinterest Ads data with other advertising platforms (Facebook, Google Ads, TikTok) in one report?</summary>

Yes. Use Coupler.io's **Append** transformation to combine data from multiple sources. For example:

1. Create a "Pinterest Ads" data flow pulling campaign spend and conversions.
2. Create a separate data flow for Facebook Ads or Google Ads.
3. In Coupler.io, add a transformation step: **Append** → select both data flows → choose how to match columns (e.g., both have "Spend" and "Conversions").
4. The output will stack all rows from both platforms.
5. Add a "Source" or "Platform" column to label which data came from where.

This works with Google Sheets, Excel, BigQuery, or any destination. From there, you can build a unified dashboard in Looker Studio. {% enddetails %

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.coupler.io/sources/category/ppc/pinterest-ads.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
