Reddit Ads API
The Reddit Ads API allows advertisers and their marketing partners to programmatically create, edit, manage, and report on advertising campaigns on the Reddit platform. It provides endpoints for managing ad accounts, campaigns, ad groups, ads, creatives, targeting configurations, custom audiences (email lists, mobile IDs, pixel-based), conversion pixels, and performance reporting. Authentication uses OAuth 2.0 with a rate limit of one request per second per advertiser account.
Reddit Ads API is one of 21 APIs that Reddit publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Advertising, Campaigns, Marketing, Social Media, and Targeting. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.
This API exposes 5 operations across 2 paths, and defines 2 schemas. It is described by OpenAPI 3.1.0, at version 3.
Requests are made against a single base URL, https://ads-api.reddit.com/api/v3.
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
Reddit Ads API declares
1 security scheme
for authenticating requests.
It supports OAuth 2.0 (oauth2) using the authorizationCode flow, exposing 1 scope.
By default, every request must be authenticated.
oauth2— Reddit Ads API uses OAuth 2.0 for authentication. Access tokens are obtained via the authorization code flow.
Paths & Operations 5
Across 2 paths, the API surfaces 5 operations — 1 DELETE, 2 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.
Endpoints for creating and managing individual ads and their associated creative content.
Schemas 2
The contract defines 2 schemas that model the data the API accepts and returns. The most detailed are Ad (10 properties), AdInput (5 properties). Each schema is shown below with its type and property counts.
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Reddit 12
Other APIs Reddit publishes across the network.