Reddit Ads Tools

Add members to a custom audience. Members must be provided as SHA256 hashes for privacy. For emails: hash the lowercase, trimmed email address. For mo...

Delete (archive) a Reddit ad. The ad will be archived and cannot be reactivated.

Delete (archive) a Reddit Ads ad group. The ad group will be archived and cannot be reactivated.

Delete (archive) a Reddit Ads campaign. The campaign will be archived and cannot be reactivated, but historical data will be preserved for reporting p...

Delete a custom audience. This permanently removes the audience and all its members. Any ad groups using this audience for targeting will be affected.

Fetch detailed information about a specific Reddit Ads account including attribution settings and account configuration.

Fetch detailed information about a specific Reddit ad including creative content, review status, and rejection reasons if applicable.

Fetch detailed information about a specific Reddit Ads ad group including targeting settings, bid configuration, and schedule.

Fetch detailed information about a specific Reddit Ads campaign including status, budget, schedule, and targeting configuration.

Fetch detailed information about a specific custom audience including size, type, and configuration.

Fetch detailed information about a specific Reddit Pixel including status, installation code, and recent activity.

Get campaign-level performance metrics including impressions, clicks, spend, CTR, CPC, conversions, and ROAS. Provides a quick overview of campaign ef...

Generate a detailed metrics report for Reddit Ads campaigns. Supports custom date ranges, granularity (daily/weekly/monthly), breakdowns by campaign/a...

List all Reddit Ads accounts accessible to the authenticated user. Returns account IDs, names, currency, timezone, and attribution settings. This is t...

List ad groups in a Reddit Ads account or campaign. Ad groups contain targeting settings and group related ads together. Returns ad group IDs, names, ...

List ads in a Reddit Ads account or ad group. Returns ad IDs, names, status, creative content, and review status.

List campaigns in a Reddit Ads account with filtering, pagination, and sorting. Returns campaign IDs, names, status, objectives, budgets, and schedule...

List custom audiences in a Reddit Ads account. Custom audiences allow targeting specific users based on email lists, mobile IDs, or website visitor da...

List conversion pixels (Reddit Pixel) in a Reddit Ads account. Pixels are used to track website visitors and conversions. Returns pixel IDs needed for...

Send server-side conversion events to Reddit Ads Conversions API (CAPI). Use for tracking conversions that happen on your server (purchases, sign-ups,...

Create or update a Reddit ad. Ads are the actual creative content that users see. When ad_id is provided, updates the existing ad. When omitted, creat...

Create or update a Reddit Ads ad group. Ad groups contain targeting settings and group related ads together. When ad_group_id is provided, updates the...

Create or update a Reddit Ads campaign. When campaign_id is provided, updates the existing campaign. When omitted, creates a new campaign with the spe...

Create or update a custom audience. After creating, use reddit_ads_add_audience_members to add users to the audience. When audience_id is provided, up...