Reddit Ads
Advertising APIs for managing Reddit campaigns, ad groups, audiences, and conversion data.
Suited to campaign creation, audience targeting, performance reporting, and reacting when conversion or spend events occur.
Use Reddit Ads with Snow
Snow is a personal AI assistant that builds real apps for you, and they can put Reddit Ads to work.
What Snow can do with Reddit Ads
These are the Reddit Ads operations Snow and the apps you build with it can run. Sign in to choose which ones Snow may run without asking.
Reads57
Look at your data without changing it.
- Get A Report
Tool to generate a metrics report for ad performance based on specified fields and breakdowns. Use when you need detailed insights and analytics on ad performance, audience engagement, impressions, clicks, spend, and other advertising metrics. Supports up to 3 breakdowns (4 with COUNTRY and REGION combination) and provides paginated results.
- Get Ad Account by ID
Tool to retrieve details for a specific Reddit ad account by ID. Use when you need to get account information including admin approval status, attribution settings, currency, excluded communities/keywords, and other account configuration. Rate limit: 400 requests per 60 seconds (Campaign Management Read).
- Get Ad Group
Tool to get an ad group by its ID from Reddit Ads API. Use when you need to retrieve details about a specific ad group. Note: Rate limit of 400 requests per 60 seconds applies (Campaign Management Read).
- Get App Last Fired At Report
Tool to retrieve the last time mobile conversion events were fired for a specific app ID. Use when you need to check conversion tracking status or verify that mobile events are being received. Rate limit: 30 requests per 60 seconds (Conversion Signals).
- Get Authenticated Member
Tool to get the authenticated member's information from the Reddit Ads API. Use when you need to retrieve details about the currently authenticated user including their Reddit username, email, name, and phone number. Rate limit: 100 requests per 60 seconds (Business Manager).
- Get Business by ID
Tool to get business details by ID from the Reddit Ads API. Use when you need to retrieve information about a specific business entity including its name, industry, contact details, and metadata. The member must have memberships to the business to access this endpoint.
- Get Campaign by ID
Retrieve a specific Reddit Ads campaign by its ID. Returns comprehensive campaign information including objective, status, budget, targeting, and optimization settings. Rate limited to 400 requests per 60 seconds.
- Get Channel Planning Reach
Tool to retrieve estimated reach data for a given set of targeting parameters. Returns a series of 10 data points representing the reach curve by impressions. Use when planning ad campaigns and estimating potential audience reach based on duration, location, age, and gender targeting.
- Get Child Funding Instruments
Tool to retrieve a list of Funding Instrument Allocations for a parent funding instrument. Use when you need to view child allocations, check billing amounts, or verify servability status. Note: This endpoint is rate-limited to 30 requests per 60 seconds under the Billing rate limit category.
- Get Custom Audience
Tool to retrieve a custom audience by ID from Reddit Ads API. Use when you need to fetch detailed information about a specific custom audience including its configuration, status, and size estimates. Rate limit: 500 requests per 60 seconds (Targeting Taxonomy).
Creates10
Add something new to your account.
- Create Ad Group
Tool to create a new ad group within a Reddit Ads campaign. Use when setting up ad groups with specific bidding strategies, budget goals, and targeting criteria. Note that optimization_goal is required for conversion, video views, catalog sales, and app install campaign objectives.
- Create Custom Audience
Tool to create a new Custom Audience in Reddit Ads. Use when you need to create a custom audience for targeted advertising campaigns. Note: This endpoint has rate limits - Custom Audiences Ingestion: 3000 requests per 900 seconds with burst limit of 500 requests per 60 seconds.
- Create Lead Gen Form
Tool to create a new lead generation form in Reddit Ads. Use when you need to set up a lead gen form to collect user information such as emails, names, phone numbers, etc. Rate limit: 20 requests per 60 seconds (Leads).
- Create Product Catalog
Tool to create a new product catalog. Use when you need to set up a product catalog for Reddit Ads. After creation, finish setup by manually creating products or linking a product feed.
- Create Product Feed
Tool to create a new feed for a product catalog. Use when setting up product feeds for Reddit catalog sales campaigns. Each catalog can contain up to 2 feeds, but they must be of different types (REPLACE or UPDATE).
- Create Product Set
Tool to create a new product set in a product catalog. Use when you need to define a subset of products from a catalog using filter rules for targeted advertising.
- Create Reddit Ads Campaign
Tool to create a new Reddit Ads campaign for the specified ad account. Use when you need to set up a new advertising campaign with specific objective, budget, and targeting settings. Note: Max campaigns creation isn't currently supported - set up Max campaigns in the Ads Manager instead.
- Create Reddit Post
Tool to create a new Reddit post for a specified profile. Use when you need to create promotional content including text, images, videos, or carousel posts. Rate limit: 200 requests per 60 seconds (Creative Management).
- Create Saved Audience
Tool to create a saved audience for a Reddit Ads ad account with targeting criteria. Use when you need to define and save audience segments for ad campaigns. Rate limit: 200 requests per 60 seconds (Campaign Management Write).
- Create Structured Post Creation Job
Tool to create a structured post creation job on Reddit Ads. Use when creating promoted posts with specific creative content (text, image, video, or carousel). Returns a job with status tracking information. Rate limit: 200 requests per 60 seconds (Creative Management).
Updates11
Change something that is already there.
- Update Ad Account
Tool to update a Reddit ad account configuration. Use when you need to modify account settings like name, attribution windows, excluded communities/keywords, or account approval state. Subject to Campaign Management Write rate limit: 200 requests per 60 seconds.
- Update Business
Tool to update a business by ID in Reddit Ads. Use when you need to modify business settings such as name, industry, country, or contact information. Rate limit: 100 requests per 60 seconds for Business Manager operations.
- Update Product Catalog
Tool to update a product catalog's name or attached Pixel IDs in Reddit Ads. Use when you need to modify catalog settings such as name or event sources.
- Update Product Feed
Tool to update a product feed's metadata in Reddit Ads. Use when you need to modify feed properties such as name, URL, mode, authentication credentials, or schedule configuration.
- Update Product Set
Tool to update a product set's name and filter rules in Reddit Ads. Use when you need to modify the name or filter conditions of an existing product set.
- Update Saved Audience
Tool to update a saved audience by ID in Reddit Ads. Use when you need to modify saved audience settings such as name, targeting criteria, or status. Rate limit: 200 requests per 60 seconds (Campaign Management Write).
- Create Batch Products
Tool to create or update multiple products in a catalog in a single batch operation. Use when you need to add up to 1000 products at once. Note: If using a schedule feed, update your feed to ensure your catalog is up to date.
- Update Campaign
Tool to update a campaign by ID in Reddit Ads. Use when you need to modify campaign settings such as name, status, budget, or targeting parameters. Rate limit: 200 requests per 60 seconds (Campaign Management Write).
- Update Custom Audience Users
Tool to update users in a Reddit Ads Custom Audience by adding or removing user identifiers. Use when you need to modify audience membership based on hashed user data like emails or mobile advertising IDs. Limited to 2,500 user entries per request.
- Update Post
Tool to update a Reddit post by ID. Use when you need to modify post settings like enabling/disabling comments. Rate limit: 200 requests per 60 seconds (Creative Management).
Deletes5
Remove something. This often cannot be undone.
- Batch Delete Products
Tool to delete multiple products from a Reddit Ads product catalog in a single request. Use when you need to remove products from a catalog. Important: This action cannot be undone, and deleted products will be permanently removed from the catalog. If using a scheduled feed, update your feed to keep the catalog synchronized.
- Delete Custom Audience
Tool to delete a Custom Audience by ID from Reddit Ads. Use when you need to permanently remove a custom audience. This operation is subject to rate limits: Custom Audiences Ingestion allows 3000 requests per 900 seconds with burst capacity of 500 requests per 60 seconds.
- Delete Product Catalog
Tool to delete a product catalog by ID from Reddit Ads. Use when you need to permanently remove a catalog. Important: This action cannot be undone.
- Delete Product Feed
Tool to delete a feed in a catalog by ID from Reddit Ads. Use when you need to permanently remove a product feed. Important: This action cannot be undone.
- Delete Product Set
Tool to delete a product set by ID from Reddit Ads. Use when you need to permanently remove a product set. Important: This action cannot be undone.
Related integrations
Ready to put Reddit Ads to work?
Sign up free, build an app by chatting, and connect Reddit Ads in minutes. No credit card required.