Reddit Ads

Reddit Ads API for managing advertising campaigns, conversions, and account data on Reddit. reddit-ads · 83 tools · no triggers

Connect it

run auth reddit-ads
run auth reddit-ads --scope team    # shared with the organization

Or from the Integrations page in the console. See Connections for personal versus shared, and who may remove one.

Use it

run reddit-ads          # common commands
run reddit-ads --all    # every command

import { redditAds } from "@boxd/run";

Common tools

Tool	What it does
`do-geolocation-validations`	Tool to validate a list of geolocations for use in Reddit Ads targeting.
`get-ad-account`	Tool to retrieve details for a specific Reddit ad account by ID.
`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.
`get-app-last-fired-at`	Tool to retrieve the last time mobile conversion events were fired for a specific app ID.
`get-report`	Tool to generate a metrics report for ad performance based on specified fields and breakdowns.
`get-business`	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…
`get-campaign`	Retrieve a specific Reddit Ads campaign by its ID. Returns comprehensive campaign information including objective, status, budget, targeting, and optimization settings.
`get-channel-planning-reach`	Tool to retrieve estimated reach data for a given set of targeting parameters.
`get-child-funding-instruments`	Tool to retrieve a list of Funding Instrument Allocations for a parent funding instrument.
`get-custom-audience`	Tool to retrieve a custom audience by ID from Reddit Ads API.
`get-lead-gen-form`	Tool to retrieve details for a specific lead generation form by ID from Reddit Ads.
`get-me`	Tool to get the authenticated member’s information from the Reddit Ads API.
`get-pixel-last-fired-at`	Tool to retrieve the last time conversion events were fired for a specific conversion pixel.
`get-post`	Tool to retrieve a promoted or organic Reddit post by its ID.
`get-product-catalog`	Tool to retrieve a specific product catalog by ID from the Reddit Ads API.
`get-product-feed`	Tool to retrieve metadata for a specific product feed by ID.
`get-product-set`	Tool to retrieve metadata for a specific product set by ID from the Reddit Ads API.
`get-profile`	Tool to retrieve details for a specific profile by ID from the Reddit Ads API.
`get-saved-audience`	Tool to retrieve a saved audience by ID from Reddit Ads API.
`get-sk-ad-network-availability`	Tool to get SKAdNetwork IDs availability quota for an iOS app.
`list-ad-accounts-by-business`	Tool to get a list of ad accounts under a business on Reddit Ads.
`list-ad-groups`	Tool to list ad groups for a Reddit ad account. Use when you need to retrieve ad groups for campaign management.
`list-campaigns`	Tool to list campaigns by ad account with pagination support.
`list-carriers`	Tool to retrieve all available carriers from Reddit Ads API for targeting purposes.
`list-communities`	Tool to list targetable communities matched by their names. Use when you need to find Reddit communities (subreddits) available for ad targeting.

All 83 tools

Tool	What it does
`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.
`create-batch-products`	Tool to create or update multiple products in a catalog in a single batch operation.
`create-campaign`	Tool to create a new Reddit Ads campaign for the specified ad account.
`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.
`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…
`create-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.
`create-product-catalog`	Tool to create a new product catalog. Use when you need to set up a product catalog for Reddit Ads.
`create-product-feed`	Tool to create a new feed for a product catalog. Use when setting up product feeds for Reddit catalog sales campaigns.
`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-saved-audience`	Tool to create a saved audience for a Reddit Ads ad account with targeting criteria.
`create-structured-post-creation-job`	Tool to create a structured post creation job on Reddit Ads.
`delete-custom-audience`	Tool to delete a Custom Audience by ID from Reddit Ads. Use when you need to permanently remove a custom audience.
`delete-product-catalog`	Tool to delete a product catalog by ID from Reddit Ads. Use when you need to permanently remove a catalog.
`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.
`delete-products`	Tool to delete multiple products from a Reddit Ads product catalog in a single request.
`delete-product-set`	Tool to delete a product set by ID from Reddit Ads. Use when you need to permanently remove a product set.
`do-geolocation-validations`	Tool to validate a list of geolocations for use in Reddit Ads targeting.
`do-keyword-validations`	Tool to validate a list of keywords for targeting and check their brand safety status.
`generate-inspiration-creative-summary`	Tool to get AI-generated summary of best practices followed by an inspiration creative ad.
`get-ad-account`	Tool to retrieve details for a specific Reddit ad account by ID.
`get-ad-account-history`	Get changelog history for a Reddit ad account with filtering options.
`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.
`get-app-last-fired-at`	Tool to retrieve the last time mobile conversion events were fired for a specific app ID.
`get-report`	Tool to generate a metrics report for ad performance based on specified fields and breakdowns.
`get-business`	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…
`get-campaign`	Retrieve a specific Reddit Ads campaign by its ID. Returns comprehensive campaign information including objective, status, budget, targeting, and optimization settings.
`get-channel-planning-reach`	Tool to retrieve estimated reach data for a given set of targeting parameters.
`get-child-funding-instruments`	Tool to retrieve a list of Funding Instrument Allocations for a parent funding instrument.
`get-custom-audience`	Tool to retrieve a custom audience by ID from Reddit Ads API.
`get-lead-gen-form`	Tool to retrieve details for a specific lead generation form by ID from Reddit Ads.
`get-me`	Tool to get the authenticated member’s information from the Reddit Ads API.
`get-pixel-last-fired-at`	Tool to retrieve the last time conversion events were fired for a specific conversion pixel.
`get-post`	Tool to retrieve a promoted or organic Reddit post by its ID.
`get-product-catalog`	Tool to retrieve a specific product catalog by ID from the Reddit Ads API.
`get-product-feed`	Tool to retrieve metadata for a specific product feed by ID.
`get-product-set`	Tool to retrieve metadata for a specific product set by ID from the Reddit Ads API.
`get-profile`	Tool to retrieve details for a specific profile by ID from the Reddit Ads API.
`get-saved-audience`	Tool to retrieve a saved audience by ID from Reddit Ads API.
`get-sk-ad-network-availability`	Tool to get SKAdNetwork IDs availability quota for an iOS app.
`get-structured-post`	Tool to retrieve a structured post by its ID from the Reddit Ads API.
`list3rd-party-audiences`	Tool to retrieve all available 3rd party audiences from Reddit Ads API for targeting purposes.
`list-ad-accounts-by-business`	Tool to get a list of ad accounts under a business on Reddit Ads.
`list-ad-groups`	Tool to list ad groups for a Reddit ad account. Use when you need to retrieve ad groups for campaign management.
`list-ads`	Tool to list ads by ad account on Reddit Ads platform. Use when you need to retrieve advertising campaigns for a specific ad account.
`list-campaigns`	Tool to list campaigns by ad account with pagination support.
`list-carriers`	Tool to retrieve all available carriers from Reddit Ads API for targeting purposes.
`list-catalog-imports`	Tool to retrieve all imports for a catalog. Use when you need to list import history and status for a specific product catalog.
`list-communities`	Tool to list targetable communities matched by their names. Use when you need to find Reddit communities (subreddits) available for ad targeting.
`list-communities-suggestions`	Tool to fetch suggested communities for given community names from Reddit Ads API.
`list-devices`	Tool to retrieve all available devices from Reddit Ads API for targeting purposes.
`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. Use when you need geographic targeting options.
`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. Use when you need to retrieve conversion pixels for a specific Reddit Ads account.
`list-pixels-by-business`	Tool to list all pixels associated with a specific business.
`list-posts`	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. Use when you need to list product sets for a specific catalog ID.
`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. Use when you need to list products within a specific product set, with optional filtering…
`list-profiles-by-ad-account`	Tool to list profiles by ad account from Reddit Ads API. Use when you need to retrieve all profiles associated with a specific ad account.
`list-profiles-by-business`	Tool to list profiles by business. Use when you need to retrieve all profiles associated with a specific business.
`list-saved-audiences`	Tool to list saved audiences for a Reddit ad account. Use when you need to retrieve saved audience configurations with their targeting details.
`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. Use when you need to retrieve custom audiences for targeting in Reddit Ads campaigns.
`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. Use when you need to modify account settings like name, attribution windows, excluded…
`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.
`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.
`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. Use when you need to modify post settings like enabling/disabling comments.
`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. Use when you need to modify feed properties such as name, URL, mode, authentication…
`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. Use when you need to modify saved audience settings such as name, targeting criteria, or status.
`update-structured-post`	Tool to update a structured post by ID. Only allow_comments can be updated on an existing structured post.

Open Reddit Ads in the console →

Getting started

Guides

Integrations and automations

Use cases

References

Connect it

Use it

Common tools

​Connect it

​Use it

​Common tools

Connect it

Use it

Common tools