Reference

Get Ad Account by ID

Retrieves detailed information about a specific Reddit ad account, including its configuration, approval status, currency settings, and content restrictions. Use this to view your account setup and verify settings before launching campaigns.

Get ad account history

Retrieve a complete changelog of all modifications made to your Reddit ad account, including details about what changed, who made the change, and when it occurred. This helps you track campaign adjustments and maintain an audit trail of your advertising activities.

Get Authenticated Member

Retrieve the current user's profile information from Reddit Ads, including username, email, and contact details. Use this to verify account access and pull authenticated user data for your advertising account.

List Ad Accounts By Business

Retrieve all ad accounts linked to a specific business on Reddit Ads, helping you manage and organize multiple advertising accounts in one place.

Create Custom Audience

Build a targeted audience list on Reddit Ads based on specific customer characteristics or behaviors to deliver ads to people most likely to engage with your brand. This allows you to focus your advertising budget on your ideal customers.

Create Saved Audience

Defines and saves custom audience segments for your Reddit ad campaigns based on specific targeting criteria, allowing you to reuse these audience profiles across multiple ads.

Delete Custom Audience

Permanently removes a custom audience from your Reddit Ads account, freeing up audience slots and cleaning up unused targeting segments. Use this when you want to delete outdated or redundant audience lists that are no longer needed for campaigns.

Get Custom Audience

Retrieve detailed information about a specific custom audience you've created in Reddit Ads, including its configuration, status, and audience size. Use this to verify audience settings before launching campaigns or to monitor audience performance over time.

Get Saved Audience

Retrieve detailed information about a specific saved audience you've created in Reddit Ads, including its targeting criteria and current status.

List 3rd Party Audiences

Retrieve all available third-party audience segments from Reddit that you can use to target your ads more precisely. This helps you find and select pre-built audience groups based on interests, demographics, or behaviors for better ad performance.

Get Child Funding Instruments

Retrieve all allocated funding instruments linked to a parent funding source, allowing you to view how your ad budget is distributed across different campaigns and billing amounts.

Get Business by ID

Retrieve detailed information about a specific business account from Reddit Ads, including name, industry, and contact details. Use this when you need to access or verify your business profile information for advertising purposes.

Create Ad Group

Create a new ad group within your Reddit Ads campaign to organize ads with specific targeting, budgets, and bidding strategies. This lets you run multiple variations of ads toward different audience segments from a single campaign.

Create Reddit Ads Campaign

Launch a new Reddit advertising campaign for your ad account with customized objectives, budget allocation, and audience targeting to reach specific Reddit communities.

List Ads

Retrieve all your advertising campaigns from a specific Reddit Ads account to monitor active promotions and campaign performance. This helps you track what ads are running and their current status across your account.

List Campaigns

Retrieve all your Reddit ad campaigns for a specific account to monitor performance and manage your advertising efforts. This operation helps you keep track of active, paused, and completed campaigns across your account.

Get Ad Group

Retrieve detailed information about a specific ad group on Reddit, including its configuration, targeting, and performance settings to monitor your advertising efforts.

Get Campaign by ID

Fetch detailed information about a specific Reddit Ads campaign, including its objective, status, budget, targeting settings, and performance configuration. Use this to review and monitor individual campaign details without having to navigate the Reddit Ads dashboard.

List Ad Groups

Retrieve all ad groups associated with your Reddit ad account to view and manage your advertising campaigns. This helps you organize and monitor your ad performance across different audience segments and targeting strategies.

List Communities

Find Reddit communities (subreddits) available for advertising your products or services by searching for communities that match your target audience interests. This helps you identify where to place your ads to reach the most relevant potential customers.

List Communities Suggestions

Discover relevant Reddit communities for your ad campaigns by searching for suggested communities based on names or website URLs. This helps you identify the best audience segments where your ads will perform well.

Create Reddit Post

Create new Reddit posts with text, images, videos, or carousels to share content and promotional material directly to your subreddit or profile. Use this to build community engagement and reach Reddit users interested in your niche.

Create Structured Post Creation Job

Creates a structured post creation job for Reddit Ads campaigns with your custom creative content like text, images, videos, or carousels. This enables you to systematically build and track promotional posts for your Reddit advertising campaigns.

Get Post by ID

Retrieve detailed information about a specific Reddit post using its ID, including content, headline, and engagement metadata. Use this to monitor your promoted posts or analyze competitor content performance.

Get Structured Post by ID

Retrieve detailed information about a specific Reddit ad post using its ID, including creative assets like images, text, videos, or carousel content. This helps you review, analyze, and manage your advertising campaigns on Reddit.

Generate Inspiration Creative Summary

Analyzes successful Reddit ads to extract best practices and generate AI-powered insights about what makes them effective, helping you understand proven creative strategies.

Create Lead Gen Form

Set up a lead generation form on Reddit to automatically collect customer information like emails and names directly from your ad campaigns without redirecting users off the platform.

Get Lead Gen Form by ID

Retrieves the complete details of a specific lead generation form from your Reddit Ads account, including form questions, prompts, and configuration settings. Use this to audit your forms or integrate form data into your marketing workflows.

Get Channel Planning Reach

Retrieves estimated audience reach data based on your targeting parameters to help you forecast campaign performance and audience size before launching ads.

Batch Delete Products

Remove multiple products from your Reddit Ads catalog at once, making it easy to clean up outdated or discontinued items from your advertising inventory.

Create Batch Products

Efficiently add or update multiple products in your Reddit Ads catalog at once, saving time when managing large product inventories. Perfect for syncing your entire catalog or making bulk updates across many items simultaneously.

Create Product Catalog

Sets up a new product catalog for your Reddit Ads campaigns, enabling you to showcase and manage your products to targeted audiences on the platform. This is the foundational step before you can run product-focused ads or sync your inventory.

Create Product Feed

Set up a new product feed to display your catalog items in Reddit shopping campaigns, enabling customers to discover and purchase your products directly on the platform.

Create Product Set

Organize your products into targeted groups using filter rules so you can run more focused advertising campaigns on Reddit. This helps you create relevant ads that reach the right customers based on specific product attributes.

Delete Product Catalog

Permanently removes a product catalog from your Reddit Ads account, allowing you to clean up unused or outdated product lists. This action cannot be reversed, so use it when you're certain you no longer need a catalog.

Delete Product Feed

Permanently removes a product feed from your Reddit Ads catalog. This action cannot be undone, so use it when you no longer need to advertise products from that feed.

Delete Product Set

Permanently remove a product set from your Reddit Ads account when you no longer need it for your campaigns. This action cannot be undone, so use it only when you're certain you want to delete the product set.

Get Product Catalog

Retrieve detailed information about a specific product catalog from your Reddit Ads account, including product lists, currency settings, and performance metrics to understand your catalog's configuration and status.

Get Product Feed

Retrieve detailed information about a product feed including its URL, schedule, and configuration settings. Use this to verify feed setup, check update frequency, and ensure your product catalog is properly connected to Reddit Ads.

Get Product Set

Retrieve detailed information about a specific product set including its name, filters, and product statistics to understand your ad inventory and targeting setup.

List Catalog Imports

Retrieve all product imports for a specific catalog to track what inventory data has been uploaded and monitor import status. This helps you verify that your product information synced correctly with Reddit's advertising system.

Get Profile by ID

Retrieve detailed profile information for a specific Reddit Ads account, including business ID and account credentials. This helps you manage multiple Reddit advertising profiles and verify account settings.

Get A Report

Retrieves detailed performance metrics and analytics for your Reddit ad campaigns, including impressions, clicks, spend, and engagement data broken down by specific dimensions. Use this to analyze campaign effectiveness and optimize your advertising ROI.

Get SKAdNetwork Availability

Check how many SKAdNetwork IDs are available for your iOS app campaigns on Reddit Ads to understand your tracking capacity before launching new ad initiatives.

List Carriers

Retrieves all available mobile carriers that you can target with Reddit ads, enabling you to reach specific audience segments based on their mobile network provider.

List Devices

Retrieves all available devices that can be targeted with Reddit ads, allowing you to refine your audience by specific device models and manufacturers. Use this to ensure your ads reach people on the devices most likely to convert for your business.

Get App Last Fired At Report

Check when mobile conversion events were last recorded for your app to verify that conversion tracking is actively receiving data from your mobile campaigns.

Get Pixel Last Fired At Report

Check when conversion events were last recorded for a specific tracking pixel to verify your conversion tracking is working properly and capturing customer actions.

Do Keyword Validations

Verify that your chosen keywords are safe for advertising and suitable for your Reddit ad campaigns by checking their brand safety status and validity. This ensures your ads reach the right audience without damaging your brand reputation.

Validate Geolocations

Check whether specific geographic locations are valid for targeting in your Reddit ad campaigns before launching or modifying your ads. This ensures your location selections are recognized by Reddit's system and prevents campaign setup errors.

List Funding Instruments

Tool to list funding instruments (payment methods) for a Reddit Ads ad account.

List Geolocations

Tool to fetch a list of geolocations from Reddit Ads API.

List Industries

Tool to retrieve all available industries from Reddit Ads API.

List Interests

Tool to retrieve all available interests from Reddit Ads API for targeting purposes.

List Lead Gen Forms

Tool to list lead generation forms for a Reddit Ads ad account.

List My Businesses

Tool to retrieve details of businesses associated with the provided access token.

List Pixels By Ad Account

Tool to list pixels by ad account.

List Pixels by Business

Tool to list all pixels associated with a specific business.

List Posts by Profile

Tool to list up to 1,000 of the most recent posts for a specified profile.

List Product Catalogs

Tool to retrieve details for all product catalogs belonging to a business.

List Product Feeds

Tool to retrieve metadata for all feeds in a product catalog.

List Product Sets

Tool to retrieve all product sets in a catalog.

List Products In Product Catalog

Tool to retrieve all products in a Reddit Ads product catalog.

List Products In Product Set

Tool to retrieve all products in a Reddit Ads product set.

List Profiles By Ad Account

Tool to list profiles by ad account from Reddit Ads API.

List Profiles By Business

Tool to list profiles by business.

List Saved Audiences

Tool to list saved audiences for a Reddit ad account.

List Structured Posts

Tool to list structured posts for a profile or retrieve up to 10 specific structured posts by ID.

List Time Zones

Tool to retrieve all available time zones from Reddit Ads API for campaign scheduling.

List User Custom Audiences

Tool to list all Custom Audiences under an ad account.

Query Ad Accounts

Tool to query ad accounts by business with optional filtering by actors, assets, roles, or custom filter string.

Query funding instruments by business

Query funding instruments (credit lines) by business with pagination support.

Search Communities

Tool to search for Reddit communities based on their name or topic.

Update Ad Account

Tool to update a Reddit ad account configuration.

Update Business

Tool to update a business by ID in Reddit Ads.

Update Campaign

Tool to update a campaign by ID in Reddit Ads.

Update Custom Audience Users

Tool to update users in a Reddit Ads Custom Audience by adding or removing user identifiers.

Update Post

Tool to update a Reddit post by ID.

Update Product Catalog

Tool to update a product catalog's name or attached Pixel IDs in Reddit Ads.

Update Product Feed

Tool to update a product feed's metadata in Reddit Ads.

Update Product Set

Tool to update a product set's name and filter rules in Reddit Ads.

Update Saved Audience

Tool to update a saved audience by ID in Reddit Ads.

Update Structured Post

Tool to update a structured post by ID.