> 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/reddit-ads.md).
# Reddit ads
Connect Reddit Ads to Google Sheets, BigQuery, or AI tools via Coupler.io. Pull campaigns, ad groups, ads, and daily performance reports automatically.
Reddit Ads is the self-serve advertising platform for Reddit, letting you run campaigns across subreddits and interest-based audiences. It supports multiple ad formats including promoted posts, video ads, and conversation ads.
Connecting Reddit Ads to Coupler.io lets you export your campaign data into the tools you already use — no manual downloads or CSV juggling required.
**Why connect Reddit Ads to Coupler.io?**
* Pull campaign performance data automatically into Google Sheets, Excel, BigQuery, or Looker Studio
* Send Reddit Ads metrics to AI tools like ChatGPT, Claude, or Gemini for analysis and reporting
* Combine Reddit Ads data with other ad platforms using Append or Join transformations to compare cross-channel performance
* Schedule automatic refreshes so your dashboards always reflect current data
## Prerequisites
Before you connect, make sure you have:
* A Reddit Ads account with at least one active ad account
* A Reddit Ads API key (generated from the Reddit Ads developer settings)
* Access to the ad accounts you want to pull data from
## Quick start
{% hint style="success" %}
Start with the **Campaign performance (daily)** entity — it gives you the richest set of metrics for analyzing what's working across your campaigns.
{% endhint %}
## How to connect
{% stepper %}
{% step %}
**Create a new data flow in Coupler.io.** Go to your Coupler.io workspace and click **Add data flow**. Search for and select **Reddit Ads** as your source.
{% endstep %}
{% step %}
**Enter your Reddit Ads API key.** In the source settings, paste your Reddit Ads API key into the authentication field. You can find or generate this key in the Reddit Ads dashboard under your account's developer/API settings.
{% endstep %}
{% step %}
**Select an entity.** Choose what data you want to pull — Campaigns, Ad groups, Ads, or Campaign performance (daily). You can add more sources to the same data flow later.
{% endstep %}
{% step %}
**Specify your ad accounts.** Enter the ad account IDs you want to extract data from. If you manage multiple accounts, you can list them all here.
{% endstep %}
{% step %}
**Set a date range (for daily performance reports).** If you selected the Campaign performance (daily) entity, use the date pickers to set a start date and end date for your report period.
{% endstep %}
{% step %}
**Choose a destination.** Select where you want your data to land — Google Sheets, Excel, BigQuery, Looker Studio, or an AI destination like ChatGPT, Claude, Gemini, Cursor, Perplexity, or OpenClaw.
{% endstep %}
{% step %}
**Run the data flow.** Click **Run** to execute a manual sync. Once it completes successfully, your Reddit Ads data will appear in your chosen destination.
{% endstep %}
{% endstepper %}
## Available entities
| Entity | Description |
| ---------------------------- | ------------------------------------------------------------------------------------------ |
| Campaign performance (daily) | Daily metrics and statistics for each campaign — great for trend analysis and optimization |
| Campaigns | Campaign names, budgets, objectives, and targeting settings |
| Ad groups | Ad group configurations, targeting criteria, and bid strategies |
| Ads | Individual ad creatives, formats, and associated metadata |
## Reddit Ads data overview
Reddit Ads in Coupler.io surfaces four entities covering everything from campaign configuration to day-by-day performance. Here's what each one contains.
## Entities
| Entity | Best for |
| ---------------------------- | ---------------------------------------------------------- |
| Campaign performance (daily) | Trend analysis, spend tracking, and optimization decisions |
| Campaigns | Budget management, objective tracking, campaign status |
| Ad groups | Audience targeting review, bid strategy audits |
| Ads | Creative performance, ad format analysis |
## Campaign performance (daily)
#### Performance metrics
| Metric | Description |
| --------------- | --------------------------------------------- |
| Impressions | Number of times ads were shown |
| Clicks | Total clicks on ads |
| CTR | Click-through rate (clicks ÷ impressions) |
| Spend | Total amount spent for the day |
| CPM | Cost per thousand impressions |
| CPC | Cost per click |
| Conversions | Total tracked conversion events |
| Conversion rate | Share of clicks that resulted in a conversion |
| Video views | Number of times video ads were viewed |
| Date | The calendar day the metrics apply to |
#### Dimensions
| Dimension | Description |
| ------------- | -------------------------------------- |
| Campaign ID | Unique identifier for the campaign |
| Campaign name | Human-readable campaign label |
| Account ID | The ad account the campaign belongs to |
## Campaigns
#### Campaign fields
| Field | Description |
| ------------- | ----------------------------------------------------- |
| Campaign ID | Unique identifier |
| Campaign name | Name of the campaign |
| Status | Active, paused, or archived |
| Objective | Campaign goal (e.g., awareness, traffic, conversions) |
| Total budget | Lifetime budget cap |
| Daily budget | Maximum daily spend |
| Start date | When the campaign is set to begin |
| End date | When the campaign is set to end |
## Ad groups
#### Ad group fields
| Field | Description |
| ------------------ | ------------------------------------------------------------ |
| Ad group ID | Unique identifier |
| Ad group name | Name of the ad group |
| Campaign ID | Parent campaign |
| Status | Active, paused, or archived |
| Bid strategy | How bids are managed (manual, auto) |
| Targeting criteria | Subreddit, interest, keyword, and location targeting details |
| Daily budget | Ad group-level spend cap |
## Ads
#### Ad fields
| Field | Description |
| ------------ | --------------------------------------- |
| Ad ID | Unique identifier |
| Ad name | Name of the ad |
| Ad group ID | Parent ad group |
| Status | Active, paused, or archived |
| Ad format | Promoted post, video, carousel, etc. |
| Creative URL | Link to the ad creative or landing page |
| Headline | Ad headline text |
## Common metric combinations
* **Spend + Impressions + CTR by date** — track daily efficiency trends over a campaign flight
* **Campaign budget vs. spend** — join Campaigns with Campaign performance (daily) to see pacing
* **Ad format vs. conversion rate** — compare performance across creative formats in the Ads entity
* **Ad group targeting + spend** — understand which audience segments are driving cost
## Use cases by role
{% tabs %}
{% tab title="Performance marketers" %}
* Export Campaign performance (daily) into Looker Studio to build a Reddit Ads performance dashboard
* Use Append in Coupler.io to combine Reddit Ads spend data with Google Ads and Meta Ads for a unified cross-channel view
* Monitor CTR and CPC trends day-over-day to catch underperforming campaigns early
{% endtab %}
{% tab title="Media planners" %}
* Pull campaign budgets and objectives into a spreadsheet to track planned vs. actual spend
* Join the Campaigns entity with Campaign performance (daily) to see how each campaign is pacing against its budget
* Use the Ads entity to maintain a creative inventory and track which formats are active
{% endtab %}
{% tab title="Analysts" %}
* Send daily performance data to BigQuery for long-term trend analysis and custom attribution modeling
* Pipe Reddit Ads metrics into ChatGPT or Claude to generate automated performance summaries
* Aggregate spend and conversions across multiple ad accounts using Coupler.io's Aggregate transformation
{% endtab %}
{% endtabs %}
## Platform-specific notes
* **CTR, CPM, CPC, and Conversion rate are not summable** — these are ratio metrics. Summing or averaging them across dates or campaigns produces incorrect results. To aggregate accurately, sum the underlying counts first (e.g., total clicks ÷ total impressions for CTR) and recalculate the ratio at the aggregation level.
* Date range parameters only apply to the **Campaign performance (daily)** entity — the other entities return current configuration data, not historical records
* If you manage multiple Reddit Ads accounts, you can specify all of them in the **Ad accounts** parameter to pull data from each in a single data flow
* Reddit Ads reporting data can have a delay of up to 24 hours, so very recent days may show incomplete numbers
* Reddit does not support breakdown dimensions (e.g., by device or placement) in the current Coupler.io integration — daily campaign-level data is the most granular available
## Reddit Ads common issues
### Connection issues
My API key isn't being accepted
Double-check that you've copied the full API key from Reddit Ads — partial keys or keys with extra spaces will fail authentication. Make sure the key is generated from the **Reddit Ads** developer settings specifically, not from your general Reddit account. If the key was recently regenerated, the old one will no longer work — re-enter the new key in your Coupler.io data flow settings.
The data flow connects but returns no data
Check that the ad account IDs you entered in the **Ad accounts** parameter are correct and that your API key has access to those accounts. If you're unsure of your account ID, log into Reddit Ads and find it in the account URL or account settings page.
### Missing data
My Campaign performance (daily) report is missing days
Verify that your start and end dates are set correctly using the date pickers — make sure the start date comes before the end date. Keep in mind that Reddit Ads reporting can lag by up to 24 hours, so data for the most recent day may be incomplete or not yet available.
Some ad accounts are missing from the results
If you manage multiple ad accounts, each one must be explicitly listed in the **Ad accounts** field. The integration does not automatically discover all accounts tied to your credentials — you need to specify each account ID you want to include.
Campaigns or ads I expected to see aren't in the export
The Campaigns, Ad groups, and Ads entities return current-state data. Deleted or archived items may not appear depending on the API's visibility rules. If you need historical records, use the **Campaign performance (daily)** entity with a date range that covers the period the campaign was active.
### Permission errors
I'm getting a "permission denied" or "unauthorized" error
Your API key may not have sufficient permissions for the ad accounts you're trying to access. In Reddit Ads, confirm that the user account that generated the API key has at least **read** access to the relevant ad accounts. If your key was created under a sub-user or restricted role, it may not be able to pull all entities.
### Data discrepancies
Numbers in Coupler.io don't match what I see in Reddit Ads
Small discrepancies are often caused by the 24-hour reporting lag in Reddit Ads — data for recent days can be revised after initial processing. If you're comparing a date range that includes the last 1-2 days, wait for those days to finalize and run the data flow again. For older date ranges, check that the date pickers in Coupler.io exactly match the range you're reviewing in the Reddit Ads interface.
### Rate limits
The data flow fails or times out with a large date range
Reddit Ads API has rate limits that can cause issues when pulling long date ranges in a single request. Try splitting your date range into shorter intervals — for example, pull one month at a time instead of a full year. You can use multiple sources within a single Coupler.io data flow with an Append transformation to combine them into one output.
## Reddit Ads FAQ
Can I pull data from multiple Reddit Ads accounts in one data flow?
Yes. Enter all the ad account IDs you want in the **Ad accounts** parameter when setting up your source. If you prefer to keep them as separate sources, you can add multiple Reddit Ads sources to one data flow and use the **Append** transformation to combine them into a single output table.
How far back can I pull Campaign performance (daily) data?
This depends on what Reddit Ads exposes through its API. In practice, you can typically pull several months of historical daily data. If you're building a long-term historical archive, it's safer to pull data in monthly chunks rather than one large request, to avoid hitting rate limits.
Why do the Campaigns, Ad groups, and Ads entities not have date range settings?
Those entities return the current state of your account configuration — they're a snapshot of what exists now. Date range filtering only applies to the **Campaign performance (daily)** entity, which is a time-series report. If you need historical performance data, that's the entity to use.
Where do I find my Reddit Ads API key?
Log into your Reddit Ads account and navigate to the developer or API settings section. From there you can generate a new API key. Make sure to copy the full key immediately after generating it — Reddit Ads typically only shows it once. Paste it into the authentication field when setting up your Coupler.io data flow.
Can I combine Reddit Ads data with other ad platforms in the same report?
Yes. Coupler.io supports the **Append** transformation, which lets you combine rows from different sources — for example, Reddit Ads and Google Ads — into one unified table. Make sure column names are consistent across sources (e.g., use the same label for "spend" or "impressions") for clean appending.
Can I send Reddit Ads data to an AI tool instead of a spreadsheet?
Absolutely. Coupler.io supports AI destinations including ChatGPT, Claude, Gemini, Cursor, Perplexity, and OpenClaw. You can route your campaign performance data directly to any of these for automated analysis, summaries, or anomaly detection.
Why are my most recent day's numbers lower than what I see in Reddit Ads?
Reddit Ads reporting has up to a 24-hour processing delay, and data for the last 1-2 days is often revised after initial ingestion. If you're seeing lower numbers than expected for recent dates, wait a day and re-run the data flow — the figures should catch up once Reddit finalizes them.
{% hint style="info" %}
For a full breakdown of available fields and metrics, see the [Data Overview](#reddit-ads-data-overview) page. If you're running into sync errors or missing data, check [Common Issues](#reddit-ads-common-issues).
{% endhint %}
---
# 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/reddit-ads.md?ask=&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.