Reddit ads

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

Start with the Campaign performance (daily) entity — it gives you the richest set of metrics for analyzing what's working across your campaigns.

How to connect

1

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.

2

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.

3

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.

4

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.

5

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.

6

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.

7

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.

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

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

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

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

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.

For a full breakdown of available fields and metrics, see the Data Overview page. If you're running into sync errors or missing data, check Common Issues.