<img height="1" width="1" style="display:none;" alt="" src="https://px.ads.linkedin.com/collect/?pid=9151474&amp;fmt=gif">
Skip to content

Connector · Social

Reddit Ads data, collected and structured for you.

Odins pulls spend from Reddit Ads every day, reads the last 90 days again each time, and structures it per campaign with the rest of your media data. Use it in Odins, in your own warehouse, or through your AI assistant.

Fully managed · reviewed November 2026

Two ways to get Reddit Ads data out.

The Reddit Ads API is open to every developer, with no approval step, and all reporting runs through one endpoint. The work sits in the details: timestamps on the hour, spend in micro units and totals that change after the day is over.

Build and run it yourself

  1. Have a business admin create a developer application in the Developer Portal in Reddit Ads. Reddit requires no allowlisting or approval.
  2. Run the OAuth 2.0 authorization code flow with the adsread scope and duration=permanent, so the token can be refreshed. Access tokens last one hour or one day.
  3. Request the report with POST /ad_accounts/{ad_account_id}/reports, naming fields and up to three breakdowns. starts_at and ends_at must be on the hour, as YYYY-MM-DDTHH:00:00Z.
  4. Follow next_url through the pages and send a descriptive User-Agent. Reporting allows 60 requests per 60 seconds for each user who authorized the app.
  5. Read past days again. Metrics can take up to 6 hours to stabilize, and late conversions are added in a daily refresh.
  6. Divide SPEND by one million, then map campaigns to your own markets and product lines.

Then monitor it, and move to a newer API version before yours reaches end of support. Reddit now releases one every quarter.

Have Odins run it

  1. Access is set up with you at onboarding, through your Odins onboarding link. Credentials are never sent by email.
  2. We sync every day and read the last 90 days again each time, so restated totals are picked up. We monitor the pipeline and maintain the connector.
  3. You get spend per campaign per day, in the same structure as every other channel.
  4. More detail, such as ad group, ad, country or placement, is added when you ask for it.

The same goes for every other source you use. One team runs all of them. See all connectors

What the Reddit Ads API offers.

The API covers campaigns, audiences, conversion events and reporting. For spend, one report endpoint does the work and a few list endpoints supply the names. Reddit's own documentation is the reference.

POST https://ads-api.reddit.com/api/v3/ad_accounts/{ad_account_id}/reports

EndpointWhat it returnsGood to know
POST /ad_accounts/{id}/reports The metrics you name in fields, split by up to three breakdowns, or four with country and region. Delivery data reaches 24 months back.
GET /ad_accounts/{id}/campaigns Campaign names, objectives and statuses.
GET /ad_accounts/{id}/ad_groups Ad group names, statuses, bid settings and targeting.
GET /businesses/{id}/ad_accounts Ad account names, currency, time zone and attribution windows. Accounts shared with the business are not returned.

Report breakdowns

  • CAMPAIGN_ID
  • AD_GROUP_ID
  • AD_ID
  • DATE
  • COUNTRY
  • REGION
  • PLACEMENT
  • KEYWORD
  • Auth OAuth 2.0, adsread scope
  • Quota 60 report requests per 60 seconds
  • History 24 months of delivery data

Worth knowing about Reddit Ads data.

Totals change after the day is over.

Reddit says metrics can take up to 6 hours to stabilize. Late conversions for an earlier hour or day are added in a daily refresh, so conversion totals you already fetched can change.

Reports are in UTC unless you ask otherwise.

Metrics default to UTC. time_zone_id moves a report to another time zone, and Reddit notes it only takes effect when the breakdowns include a date.

Spend comes in micro units, without VAT.

SPEND, CPC and ECPM are returned in microcurrency, so divide by one million. The CURRENCY field gives the account's currency. Spend arrives excluding VAT.

History stops at 24 months.

Delivery data goes back 24 months, and reach and frequency data start in June 2024. Older spend has to come from your own records or exports.

What you get back.

Two layers. The raw one mirrors Reddit Ads. The structured one is the table every source lands in, organised by your own markets and product lines.

Structured layer

Per campaign, per day
In the structured tableFor Reddit Ads
DateDaily
Company and marketSet by your routing rules on campaign names
Channel and mediaFollows your media plan
Source campaignCampaign
SpendSpend, excluding VAT

Raw layer

As Reddit returns it

Daily spend per campaign as the Reddit Ads API reports it. More detail is added on request.

Use it where you work.

In your warehouse

Raw and structured tables delivered to BigQuery, Snowflake, Redshift or Databricks. Some customers use Odins for this alone.

How data integration works

In Odins

Reporting across every channel, and a model that shows what Reddit contributes and where more spend still pays.

See the platform

Through your AI assistant

Connect Claude, ChatGPT or Copilot to Odins with MCP and ask for the numbers in plain language.

How the Odins MCP works

Questions.

Does Reddit Ads have an API?

Yes. The Reddit Ads API is open to all developers and needs no allowlisting or approval from Reddit. It authenticates with OAuth 2.0 through a developer application, and reporting runs through one endpoint, Get A Report.

How do I get Reddit Ads data into BigQuery?

Access is set up with you at onboarding, through your Odins onboarding link. Odins syncs daily and delivers raw tables plus one structured cross-channel dataset to your BigQuery project.

Why do Reddit Ads numbers change after the day is over?

Reddit adds late conversions for earlier days in a daily refresh. Odins reads the last 90 days again on every sync, so the stored figures follow Reddit's.

Which version of the Reddit Ads API should we build on?

A supported Stable version. Reddit now releases a new version each quarter, and each is Stable for four quarters. v3 is supported until the end of the third quarter of 2027; after that, requests to it return 410 Gone. v4 becomes Stable in the first quarter of 2027.

Your sources

Send us your list of sources.

Tell us which platforms you use. We reply with what is covered, how access works and what you get back.

Send your list
The Odins letter

Where marketing budgets work hardest, once a month.

One short email: a question about marketing investment, answered with numbers, and what it means for the next budget decision.

  • One email a month
  • Written by the team that builds and runs the models

Protected by reCAPTCHA: Google's Privacy Policy and Terms apply.