Reddit Ads

Delete Custom Audience: Delete a custom audience. (DELETE /api/v3/custom_audiences/{audience_id})

Delete Product Catalog: Delete a catalog. > **Important:** This action can't be undone. (DELETE /api/v3/product_catalogs/{catalog_id})

Delete Product Feed: Delete a feed in a catalog. > **Important:** This action can't be undone. (DELETE /api/v3/product_feeds/{feed_id})

Delete Product Set: Delete your product set. > **Important:** This action can't be undone. (DELETE /api/v3/product_sets/{product_set_id})

Get Ad Account: Retrieve ad account by ID. (GET /api/v3/ad_accounts/{ad_account_id})

List Ad Groups: Retrieve ad groups by ad account. (GET /api/v3/ad_accounts/{ad_account_id}/ad_groups)

List Ads: Retrieve ads by ad account. Filters combine with logical AND across different query parameters. For multi-value filters, comma-separated values within the same query parameter use logical OR. For example, `?configured_status=ACTIVE,PAUSED&effective_status=PENDING_APPROVAL` returns ads whose configured status is `ACTIVE` or `PAUSED` and whose effective status is `PENDING_APPROVAL`. > **Tip:** Only 1 ad will appear for each Max campaign. Learn about [Max campaigns](https://business.reddithelp.com/s/article/max-campaigns). (GET /api/v3/ad_accounts/{ad_account_id}/ads)

List Apps By Ad Account: Retrieve mobile app identifiers previously used in [app install](https://business.reddithelp.com/s/article/app-install-ads) campaigns. Each returned item includes only the `id` field (App Store or Google Play identifier). ## Things to know - The set reflects apps already used in past campaign activity, not every app you may target in the future. - `page.token` and `page.size` are accepted for consistency with other list endpoints; pagination is not applied yet, so `pagination.next_url` and `pagination.previous_url` are always null. (GET /api/v3/ad_accounts/{ad_account_id}/apps)

List Campaigns: Retrieve campaigns by ad account. (GET /api/v3/ad_accounts/{ad_account_id}/campaigns)

List User Custom Audiences: Retrieve custom audiences associated with an ad account. (GET /api/v3/ad_accounts/{ad_account_id}/custom_audiences)

List Funding Instruments: Retrieve funding instruments used by an ad account. (GET /api/v3/ad_accounts/{ad_account_id}/funding_instruments)

List Lead Gen Forms: Retrieve the lead generation forms in an ad account. (GET /api/v3/ad_accounts/{ad_account_id}/lead_gen_forms)

List Pixels By Ad Account: Retrieve Pixels associated with an ad account. > **Important:** Starting July 13th, 2026, a Pixel is required for all ad groups and CBO campaigns. If no Pixels are currently associated with your ad account, set up your Pixel in the [Events Manager](https://ads.reddit.com/events-manager). (GET /api/v3/ad_accounts/{ad_account_id}/pixels)

List Profiles By Ad Account: Retrieve profiles associated with an ad account. (GET /api/v3/ad_accounts/{ad_account_id}/profiles)

List Saved Audiences: List saved audiences. (GET /api/v3/ad_accounts/{ad_account_id}/saved_audiences)

Get Ad Group: Retrieve an ad group. (GET /api/v3/ad_groups/{ad_group_id})

Get Ad: Retrieve an ad. (GET /api/v3/ads/{ad_id})

Get App Last Fired At: Retrieve the last time [App Install events](https://business.reddithelp.com/s/article/app-install-ads#supported-events) fired for a specific app ID. (GET /api/v3/apps/{app_id}/last_fired_at_report)

Get SKAdNetwork Availability: Retrieve the SKAdNetwork (SKAD) IDs availability quota for an app. Learn more about [SKAD IDs](https://business.reddithelp.com/s/article/skadnetwork). ## iOS App Install active limits * 10 campaigns per app ID (shared across all ad accounts) * 5 ad groups per campaign * 10 ads per ad group (GET /api/v3/apps/{app_id}/skan_availability)

Get Business: Retrieve business by ID. (GET /api/v3/businesses/{business_id})

List Ad Accounts By Business: Retrieve the ad accounts in a business. > **Note:** Ad accounts [shared with the business](https://business.reddithelp.com/s/article/partner-sharing) won't be returned. (GET /api/v3/businesses/{business_id}/ad_accounts)

List Pixels By Business: Retrieve Pixels associated with a business. (GET /api/v3/businesses/{business_id}/pixels)

List Product Catalogs: Retrieve details for all catalogs for your business. (GET /api/v3/businesses/{business_id}/product_catalogs)

List Profiles By Business: Retrieve profiles associated with a business. (GET /api/v3/businesses/{business_id}/profiles)

Get Campaign: Retrieve a campaign. (GET /api/v3/campaigns/{campaign_id})

List Catalog Import Issues: Retrieve a list of the catalog's import issues. See [troubleshooting](https://business.reddithelp.com/s/article/troubleshoot-catalogs) and [catalog requirements](https://business.reddithelp.com/s/article/catalog-requirements) for more details. (GET /api/v3/catalog_imports/{import_id}/issues)

Get Catalog Import Report: Retrieve metadata for a specific catalog import. Access the URL to download details on product processing statuses and issues. (GET /api/v3/catalog_imports/{import_id}/report)

Get Channel Planning Reach: Retrieve a 10-point reach curve at different impression levels based on targeting. (GET /api/v3/channel_planning/reach)

Get Creative Asset: Fetch metadata for your creative asset. Learn about the [asset library](https://business.reddithelp.com/s/article/asset-library). > **Note:** Asset library requires the Max campaign type, which is in beta. [Reach out to a Reddit Ads expert](https://www.business.reddit.com/speak-with-a-reddit-ads-expert) for more details. (GET /api/v3/creative_assets/{creative_asset_id})

Get Custom Audience: Retrieve a custom audience. (GET /api/v3/custom_audiences/{audience_id})

Get Data Deletion Job Status: Retrieve the current status of a data deletion job. Deletions are processed daily, so poll once per day until the job reaches `COMPLETED` or `FAILED`. View the [polling guidance](/docs/v3/guides/programs/data-deletion/delete-user-data#best-practices). (GET /api/v3/data_deletion_jobs/{job_id})

Get Child Funding Instruments: Retrieve funding instrument allocations. (GET /api/v3/funding_instruments/{funding_instrument_id}/allocations)

List Industries: List supported industries. (GET /api/v3/industries)

Get Lead Gen Form: Retrieve a lead generation form. (GET /api/v3/lead_gen_forms/{lead_gen_form_id})

Get Me: Retrieve the authenticated user. (GET /api/v3/me)

List my businesses: Retrieve all businesses associated with the authenticated user. Apply filters to narrow results by the user's access. (GET /api/v3/me/businesses)

Get Last Fired At: Retrieve the last time a Pixel was fired for conversion events ([ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)). (GET /api/v3/pixels/{pixel_id}/last_fired_at)

Get Post: Retrieve a post. > **Note:** This is a legacy endpoint. Use [`Get Structured Post`](https://ads-api.reddit.com/docs/v3/operations/Get%20Structured%20Post) instead. (GET /api/v3/posts/{post_id})

Get Product Catalog: Retrieve a catalog. (GET /api/v3/product_catalogs/{catalog_id})

List Catalog Imports: Retrieve all imports for a catalog. (GET /api/v3/product_catalogs/{catalog_id}/catalog_imports)

List Product Feeds: Retrieve metadata for all feeds in a catalog. (GET /api/v3/product_catalogs/{catalog_id}/product_feeds)

List Product Sets: Retrieve all product sets in a catalog. (GET /api/v3/product_catalogs/{catalog_id}/product_sets)

List Products In Product Catalog: Retrieve all products in a catalog. (GET /api/v3/product_catalogs/{catalog_id}/products)

Get Product Feed: Retrieve metadata for a specific feed. (GET /api/v3/product_feeds/{feed_id})

Get Product Set: Retrieve metadata for a specific product set. (GET /api/v3/product_sets/{product_set_id})

List Products In Product Set: Retrieve all products in a product set. (GET /api/v3/product_sets/{product_set_id}/products)

Get Profile: Retrieve profile by ID. (GET /api/v3/profiles/{profile_id})

List Creative Assets: Retrieve all creative assets associated with your profile. Learn how to use the [asset library](https://business.reddithelp.com/s/article/asset-library). > **Note:** Asset library requires the Max campaign type, which is in beta. [Reach out to a Reddit Ads expert](https://www.business.reddit.com/speak-with-a-reddit-ads-expert) for more details. (GET /api/v3/profiles/{profile_id}/creative_assets)

List Posts: Retrieve up to 1,000 posts for a profile. > **Note:** This is a legacy endpoint. Use [`List Structured Posts`](https://ads-api.reddit.com/docs/v3/operations/List%20Structured%20Posts) instead. (GET /api/v3/profiles/{profile_id}/posts)

List Structured Posts: Retrieve structured posts by profile. (GET /api/v3/profiles/{profile_id}/structured_posts)

Get Saved Audience: Retrieve a saved audience. (GET /api/v3/saved_audiences/{saved_audience_id})

Get Structured Post: Retrieve a structured post. (GET /api/v3/structured_posts/{post_id})

Get Structured Post Creation Job: Retrieve a structured post creation job. (GET /api/v3/structured_posts/jobs/{post_creation_job_id})

List Carriers: Retrieve details on [targetable carriers](https://business.reddithelp.com/s/article/Overview-Reddit-Ads-Audience-and-Targeting#device-and-carrier). (GET /api/v3/targeting/carriers)

List Communities: Retrieve details on [targetable communities](https://business.reddithelp.com/s/article/reddit-audiences#community-targeting). (GET /api/v3/targeting/communities)

Search Communities: Find [targetable communities](https://business.reddithelp.com/s/article/reddit-audiences#community-targeting) based on their name or topic. (GET /api/v3/targeting/communities/search)

List Communities Suggestions: Retrieve suggested communities based on keywords and/or a website. (GET /api/v3/targeting/communities/suggestions)

List Devices: Retrieve details on [targetable devices](https://business.reddithelp.com/s/article/Overview-Reddit-Ads-Audience-and-Targeting#device-and-carrier). (GET /api/v3/targeting/devices)

List Geolocations: Retrieve details on [targetable geolocations](https://business.reddithelp.com/s/article/demographics#location-targeting). (GET /api/v3/targeting/geolocations)

List Interests: Retrieve details on [targetable interests](https://business.reddithelp.com/s/article/reddit-audiences#interest-targeting). (GET /api/v3/targeting/interests)

List Languages: Retrieve details on [targetable languages](https://business.reddithelp.com/s/article/demographics#language-targeting). (GET /api/v3/targeting/languages)

List 3rd Party Audiences: Retrieve details on supported third-party audiences. (GET /api/v3/targeting/third_party_audiences)

Get Third Party Trackers: Retrieve domains recognized for click and impression tracking before creating or updating ads. > **Note:** A listed domain does not guarantee that every tracker URL using it is valid. (GET /api/v3/third_party_trackers)

List Time Zones: List supported time zones. (GET /api/v3/time_zones)

Update Ad Account: Update an ad account. (PATCH /api/v3/ad_accounts/{ad_account_id})

Update Ad Group: Update an ad group. When `shopping_type` is `DYNAMIC`, see the `targeting` field description for which fields are applied. (PATCH /api/v3/ad_groups/{ad_group_id})

Update Ad: Update an ad. For catalog sales ads using `shopping_creative`, see `click_url` for how it is handled. (PATCH /api/v3/ads/{ad_id})

Update Business: Update business by ID. (PATCH /api/v3/businesses/{business_id})

Update Campaign: Update a campaign. (PATCH /api/v3/campaigns/{campaign_id})

Update Custom Audience Users: Update users in a custom audience. Limited to 2,500 `user_data` entries per request. Learn more about [managing custom audiences](https://ads-api.reddit.com/docs/v3/manage-customer-lists). (PATCH /api/v3/custom_audiences/{audience_id}/users)

Update Post: Update a post. > **Note:** This is a legacy endpoint. Create a [structured post](https://ads-api.reddit.com/docs/v3/operations/Create%20Structured%20Post%20Creation%20Job) instead. (PATCH /api/v3/posts/{post_id})

Update Product Catalog: Change a catalog's name or attached Pixel ID. (PATCH /api/v3/product_catalogs/{catalog_id})

Update Product Feed: Change a feed's metadata. (PATCH /api/v3/product_feeds/{feed_id})

Update Product Set: Change a specific product set's name and filters. (PATCH /api/v3/product_sets/{product_set_id})

Update Saved Audience: Update a saved audience. (PATCH /api/v3/saved_audiences/{saved_audience_id})

Update Structured Post: Modify `allow_comments` on an existing structured post. [Create another structured post](https://ads-api.reddit.com/docs/v3/operations/Create%20Structured%20Post%20Creation%20Job) to change other parts of the ad, such as the headline or assets. (PATCH /api/v3/structured_posts/{post_id})

Create Ad Group: Create an ad group. > **Important:** Starting July 13th, 2026, `conversion_pixel_id` is required for all ad groups. Retrieve your Pixel with [`List Pixels by Ad Account`](https://ads-api.reddit.com/docs/v3/operations/List%20Pixels%20By%20Ad%20Account). ## Optimization goal options `optimization_goal` is required for [conversion](https://business.reddithelp.com/s/article/About-Reddit-Ads-conversion-tracking), [video views](https://business.reddithelp.com/s/article/video-goals), [catalog sales](https://business.reddithelp.com/s/article/catalogs), and [app install](https://business.reddithelp.com/s/article/app-install-ads) campaign objectives. Conversion > **Note:** Starting May 5th, `VIEW_CONTENT`, `SEARCH`, and `ADD_TO_WISHLIST` will no longer be supported for **new ad groups**. Existing ad groups using these goals won't be affected, but they can't be created, extended, duplicated, or replicated. - `PAGE_VISIT` - `VIEW_CONTENT` - `SEARCH` - `ADD_TO_CART` - `ADD_TO_WISHLIST` - `PURCHASE` - `LEAD` - `SIGN_UP` - `CLICKS` > **Note:** `CLICKS` is only available if neither Pixel nor CAPI has been set up. Video views > **Important:** Starting **March 31st, 2026**, `NULL` is no longer supported. Set to a valid video goal to prevent issues. Learn about [video goals](https://business.reddithelp.com/s/article/video-goals). - `VIDEO_VIEW_6S` - `VIDEO_VIEW_15S` > **Note:** `VIDEO_VIEW_15S` requires a `bid_type` of `CPV15`. Catalog sales - `PURCHASE` - `CLICKS` > **Note:** `CLICKS` is only available if neither Pixel nor CAPI has been set up. App install > **Note:** Learn more about [app event goals](https://business.reddithelp.com/s/article/app-event-optimization). - `MOBILE_CONVERSION_INSTALL` - `MOBILE_CONVERSION_SIGN_UP` - `MOBILE_CONVERSION_ADD_PAYMENT_INFO` - `MOBILE_CONVERSION_ADD_TO_CART` - `MOBILE_CONVERSION_PURCHASE` - `MOBILE_CONVERSION_COMPLETED_TUTORIAL` - `MOBILE_CONVERSION_LEVEL_ACHIEVED` - `MOBILE_CONVERSION_SPEND_CREDITS` - `MOBILE_CONVERSION_REINSTALL` - `MOBILE_CONVERSION_UNLOCK_ACHIEVEMENT` - `MOBILE_CONVERSION_START_TRIAL` - `MOBILE_CONVERSION_SUBSCRIBE` - `MOBILE_CONVERSION_ONBOARD_STARTED` - `MOBILE_CONVERSION_FIRST_TIME_PURCHASE` When `shopping_type` is `DYNAMIC`, see the `targeting` field description for which fields are applied. (POST /api/v3/ad_accounts/{ad_account_id}/ad_groups)

Create Ad: Create an ad. For catalog sales ads using `shopping_creative`, see `click_url` for how it is handled. (POST /api/v3/ad_accounts/{ad_account_id}/ads)

Create Campaign: Create a campaign. > **Important:** Starting July 13th, 2026, `conversion_pixel_id` is required for all campaign budget optimization campaigns. Retrieve your Pixel with [`List Pixels by Ad Account`](https://ads-api.reddit.com/docs/v3/operations/List%20Pixels%20By%20Ad%20Account). > **Note:** Max campaigns creation isn't currently supported in the Reddit Ads API. Set up Max campaigns in the [Ads Manager](https://business.reddithelp.com/s/article/max-campaigns). (POST /api/v3/ad_accounts/{ad_account_id}/campaigns)

Create Custom Audience: Create a custom audience. Learn more about [managing custom audiences](https://ads-api.reddit.com/docs/v3/manage-customer-lists). (POST /api/v3/ad_accounts/{ad_account_id}/custom_audiences)

Create Data Deletion Job: Create an asynchronous job to delete ads-related data for supported user identifiers. Prefer pre-hashed identifiers when supported. Learn more about [deleting user data ](/docs/v3/guides/programs/data-deletion/delete-user-data). (POST /api/v3/ad_accounts/{ad_account_id}/data_deletion_jobs)

Audience and Delivery Estimates: Estimate audience size and delivery outcomes for the provided campaign and ad group configurations. Outcomes that don't apply with the selected objective and optimization goal are omitted. Learn about [audience estimates](https://business.reddithelp.com/s/article/Overview-Reddit-Ads-Audience-and-Targeting#audience-estimates). (POST /api/v3/ad_accounts/{ad_account_id}/forecasting/audience_and_delivery_estimates)

Get Ad Account History: Retrieve the changelog for an ad account. > **Tip:** Send an empty JSON object (`{}`) to return all changes made to the ad account. (POST /api/v3/ad_accounts/{ad_account_id}/history)

Create Lead Gen Form: Create a lead generation form. (POST /api/v3/ad_accounts/{ad_account_id}/lead_gen_forms)

Get A Report: Generate a metrics report for up to 3 `breakdowns` (4 with `country` and `region`) based on the `fields` you provide. Reports provide detailed insights and analytics on ad performance, audience engagement, and other relevant metrics. > **Note:** Top combinations aren't currently supported. View these metrics in the [Ads Manager](https://business.reddithelp.com/s/article/the-dashboard#view-audience-insights). ## Considerations - Metrics default to Coordinated Universal Time (UTC). Change time zone by setting `time_zone_id`. - Filters can be added to limit entity types or conversion data. Learn about [applying filters](https://ads-api.reddit.com/docs/v3/filter-reporting-metrics). - Some values are converted in your report. To return the value: > **Note:** The asterisk (`*`) represents any character(s). For example, `CONVERSION*TOTAL_VALUE` matches any metrics starting with `CONVERSION` and ending with `TOTAL_VALUE`. - **Divide by 100:** `CONVERSION*TOTAL_VALUE` - **Divide by 1 million:** `SPEND`, `CPC`, `CPV`, `ECPM`, `APP_INSTALL*ECPA`, `APP_INSTALL_SKAN*`, `APP_INSTALL*REVENUE`, and `CONVERSION*ECPA` - We recommend including the `ad_id` breakdown. Use joins in [`Get Ad`](https://ads-api.reddit.com/docs/v3/operations/Get%20Ad) to retrieve IDs. - Metrics may take up to 6 hours to stabilize. Conversion data continues updating as events occur. - Delivery data goes back by 24 months. Reach and frequency data start June 2024. (POST /api/v3/ad_accounts/{ad_account_id}/reports)

Create Saved Audience: Create a saved audience in an ad account. (POST /api/v3/ad_accounts/{ad_account_id}/saved_audiences)

Query Ad Accounts: Find ad accounts in a business. (POST /api/v3/businesses/{business_id}/ad_accounts/query)

Query Funding Instruments by Business: Find funding instruments in a business. (POST /api/v3/businesses/{business_id}/funding_instruments/query)

Create Product Catalog: Create a new product catalog. Finish setup by [manually creating products](https://ads-api.reddit.com/docs/v3/operations/Batch%20Create%20Products) or [linking a product feed](https://ads-api.reddit.com/docs/v3/operations/Create%20Product%20Feed). (POST /api/v3/businesses/{business_id}/product_catalogs)

Generate Bid Suggestion: Retrieve bid suggestions based on recent auction outcomes for a given set of targeting, budget, and bidding parameters. Use the suggested range to choose a competitive bid. (POST /api/v3/forecasting/bid_suggestions)

Post Conversion Events: Post conversion events from a specific [action source](https://business.reddithelp.com/s/article/Conversions-API#measure-impact-across-channels). [Event deduplication](https://business.reddithelp.com/s/article/event-deduplication) applies only for events in the same channel. Learn more about [setting up CAPI events](https://ads-api.reddit.com/docs/v3/capi-direct-integration). > **Important:** The values for several fields—such as `tracking_type`—are different in CAPI v3. Learn how to [migrate from v2](https://ads-api.reddit.com/docs/v3/capi-migration). (POST /api/v3/pixels/{pixel_id}/conversion_events)

Create Product Feed: Set up a new feed for a catalog. Each catalog can contain up to 2 feeds, but they must be of different types. (POST /api/v3/product_catalogs/{catalog_id}/product_feeds)

Create Product Set: Create a new product set in a catalog. (POST /api/v3/product_catalogs/{catalog_id}/product_sets)

Batch Delete Products: Delete multiple products in a catalog. > **Important:** This action can't be undone. > **Note:** If using a schedule feed, update your feed to ensure your catalog is up to date. (POST /api/v3/product_catalogs/{catalog_id}/products/batch_delete)

Batch Create Products: Create multiple products in a catalog. View our [catalog requirements](https://business.reddithelp.com/s/article/catalog-requirements). > **Note:** If using a schedule feed, update your feed to ensure your catalog is up to date. (POST /api/v3/product_catalogs/{catalog_id}/products/batch_upsert)

Create Post: Create a post. > **Note:** This is a legacy endpoint. Use [`Create Structured Post Creation Job`](https://ads-api.reddit.com/docs/v3/operations/Create%20Structured%20Post%20Creation%20Job) instead. (POST /api/v3/profiles/{profile_id}/posts)

Create Structured Post Creation Job: Create a structured post creation job. (POST /api/v3/profiles/{profile_id}/structured_posts/jobs)

Do Geolocation Validations: Verify whether certain geolocations are targetable. Invalid geolocations will return an error message. (POST /api/v3/targeting/geolocations_validations)

List Keyword Suggestions: Retrieve keyword suggestions seeded from a list of input terms. Each suggestion includes its monthly view count. (POST /api/v3/targeting/keyword_suggestions)

Do Keyword Validations: Validate whether certain [keywords are targetable](https://business.reddithelp.com/s/article/reddit-audiences#keyword-targeting). (POST /api/v3/targeting/keyword_validations)