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
- Have a business admin create a developer application in the Developer Portal in Reddit Ads. Reddit requires no allowlisting or approval.
- Run the OAuth 2.0 authorization code flow with the
adsreadscope andduration=permanent, so the token can be refreshed. Access tokens last one hour or one day. - Request the report with
POST /ad_accounts/{ad_account_id}/reports, namingfieldsand up to threebreakdowns.starts_atandends_atmust be on the hour, asYYYY-MM-DDTHH:00:00Z. - Follow
next_urlthrough the pages and send a descriptiveUser-Agent. Reporting allows 60 requests per 60 seconds for each user who authorized the app. - Read past days again. Metrics can take up to 6 hours to stabilize, and late conversions are added in a daily refresh.
- Divide
SPENDby 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
- Access is set up with you at onboarding, through your Odins onboarding link. Credentials are never sent by email.
- 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.
- You get spend per campaign per day, in the same structure as every other channel.
- 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
| Endpoint | What it returns | Good 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_IDAD_GROUP_IDAD_IDDATECOUNTRYREGIONPLACEMENTKEYWORD
- 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 table | For Reddit Ads |
|---|---|
| Date | Daily |
| Company and market | Set by your routing rules on campaign names |
| Channel and media | Follows your media plan |
| Source campaign | Campaign |
| Spend | Spend, excluding VAT |
Raw layer
As Reddit returns itDaily 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.
In Odins
Reporting across every channel, and a model that shows what Reddit contributes and where more spend still pays.
Through your AI assistant
Connect Claude, ChatGPT or Copilot to Odins with MCP and ask for the numbers in plain language.
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.
-1.png?width=1132&height=292&name=Asset%201@2x%20(12)-1.png)