About the Reddit Ads API

The Reddit Ads API lets advertisers tap into the Reddit Ads Platform to build and manage advertising campaigns and accounts without directly stepping into the Ads Manager. By integrating Reddit Ads API into your tooling, you can:

• Seamlessly manage and optimize campaigns. Increase your return on ad spend (ROAS) with automated ad template creation, dynamic creative permutations, real-time optimization, campaign notifications, and more.
• Customize audience targeting. Enhance campaign effectiveness by importing tailored audience segments from your customer relationship management (CRM) or customer data partner (CDP) partners.
• Enhance reporting and analytics. Build custom dashboards to compare ad performance across channels and create unique automated reports on different elements of your campaigns.

We recommend using the Reddit Ads API if:

• You manage client digital ads and commerce-related activities on Reddit.
• You manage ad spending directly and have a significant advertising scale on Reddit.
• You need a custom solution that leverages your internal data.

Implementation requires some technical skill. If that's not in your wheelhouse, you might want to ask the right technical support person on your team for assistance.

Do you learn better by watching? Watch the next video or check out other tutorials on the Ads Formula.

Considerations before you integrate

Before you begin, you should be familiar with the Reddit Ads API requirements and product functionality: 

• Your use of CAPI is subject to the same agreements in the Ads API Terms and Reddit Business Tool Terms.
• Everyone can get read access for reporting without approval. If you're interested in write access, developers must apply before gaining access to the platform.
• Unless explicitly stated, alpha or beta products aren't supported in the Reddit Ads API. Future changes may introduce new limitations.

Before you start

• Set up a Reddit Ads account. You'll need to request access to the Ads API. If you're using the v2 integration, your account team must allow the Pixel IDs you want to connect in Business > Accounts. 
• Find your ads account ID. Let us know which business account to fetch data from. You can find your ads account ID in Accounts.
• Generate an access token. We recommend creating a developer access token. If you're only using the Conversions endpoint, you can generate a conversion access token so you don't have to worry about it expiring.

Integrate the Reddit Ads API

There are several ways you can set up the Reddit Ads API:

• Direct integration. If you want more flexibility and control of your data, we recommend a direct integration using the Reddit Ads API. This method requires some in-house developer resources to set up.
• Supported partner integrations. Implement the Reddit Ads API using one of our trusted partners to simplify setup, avoid errors, and save development resources.

Need help choosing the best solution for you? Reach out to your Reddit representative, or contact us for support. 

Best practices

We strongly recommend working with an internal technology team or connecting to the API using one of our partners for the best results. Need help choosing the best solution for you? Reach out to your Reddit representative, or contact us for support.

Verify your integration

• POST Get me: Confirm that an API connection has been established by retrieving information on the account authenticated with your token. This doesn't require any parameters besides your access token.
• POST Get a report: Generate a metrics report for detailed insights and analytics on ad performance, audience engagement, and other relevant metrics. You can also use this endpoint to verify custom conversion events.