Skip to main content
Feedback

Reddit Ads walkthrough

info

Reddit Ads API version 3 is currently supported.

Reddit Ads is an online community where users can share links, produce content, and conduct discussions about topics that interest them.

Connection

To connect Reddit Ads API v3 with your destination, refer Reddit Ads connection.

Procedure

  1. Navigate to the Data Integration Console.
  2. Select the Reddit Ads connection that you created or create a new one.
  3. Select a report from the Report drop-down list.

Reports

Reddit Ads supports two types of reports:

Predefined reports

Click here to view Predefined Reports.

Custom reports

Create custom reports, and select a specific report to pull data from the Reddit Ads API v3 after establishing a connection. The following custom reports are available:

  • Accounts
  • Campaigns
  • Ads
  • Ad Groups
  • Reports
  • Geo Locations
  • Communities

Only Reports lets you extract incremental data by selecting a time period.

image.png

note
  • Start Date is mandatory.
  • Retrieves Data for the date range specified between the start and end dates.
  • If you leave the end date blank, Data Integration pulls the data at the current time of the Data Flow's run.
  • Dates follow UTC timezone.
  • Use the Last Days Back For Each Run option to gather data from a specified number of days before the selected start date.

Pulling data for specific date ranges

The Reddit Ads API returns data in strict 24-hour UTC windows based on precise timestamp boundaries. To keep your reports aligned with the Reddit Ad Manager and prevent duplicate or incorrect metrics, use these configuration settings.

Pulling data for a specific day

To pull data for one specific day, provide the exact same date and time for both the Start Date and End Date. The request_end_date parameter marks the boundary of that specific window, rather than a second day.

Example (UTC midnight): To pull all data for February 1, 2026:

  • Start Date: 2026-02-01 00:00:00
  • End Date: 2026-02-01 00:00:00

Handling local timezones (offsets)

Data Integration operates in UTC and does not support IANA timezone strings (such as America/New_York). When your local day aligns with UTC midnight, use the same timestamp for both fields. When it does not, you must manually adjust the time components to your local timezone and the end timestamp shifts to the next calendar date in UTC.

Example — pulling a single day in EST (UTC−5):

To pull all data for February 1 in Eastern Standard Time:

  • Start date: 2026-02-01 05:00:00
  • End date: 2026-02-02 05:00:00

This aligns the 24-hour window to EST midnight-to-midnight boundaries.

tip

  • To pull all data for yesterday without manual date entry, set the time period to Yesterday. This automatically queries from the start to the end of the previous day based on the Data Flow run time.

  • If you are querying specific date ranges but want the Start Date to automatically reset to the effective execution End Date after each successful run, ensure that Incremental Mode is turned ON in your river settings.

Limitation

All the reported data reflects values as of three hours before the time of retrieval. For example, if you fetch impressions at 6 PM, the data will be available only up to 3 PM.

On this Page