TikTok Ads

Tools 38

• Advertiser Info Get

  Retrieves details for one or more advertiser ad accounts from `/open_api/v1.3/advertiser/info/`. To add a partner and assign ad accounts to that partner, use `/bc/partner/add/`, set `asset_type` to `ADVERTISER`, and pass advertiser IDs in `asset_ids`. Advertiser IDs can be obtained from `/oauth2/advertiser/get/`.

• App Info Get

  Retrieves details for an app in Events API. Endpoint: /v1.3/app/info/. By using Events API endpoints, you agree to the TikTok Business Products (Data) Terms (https://ads.tiktok.com/i18n/official/policy/business-products-terms) and must not share sensitive data with TikTok. Compared with v1.2, v1.3 changes `advertiser_id` and `app_id` request types from number to string, changes response field `is_skan_allowed` to `skan_allowed`, changes related ID response types from number to string, and adds `self_attribution_enabled` and `advanced_dedicated_campaign_allowed` in the response.

• App List Get

  Returns the list of apps under the specified advertiser account from `/open_api/v1.3/app/list/`. You can optionally filter the result by app platform IDs. By using Events API endpoints, you agree to the TikTok Business Products (Data) Terms at https://ads.tiktok.com/i18n/official/policy/business-products-terms and that you will not share sensitive data with TikTok. This page also notes v1.2 to v1.3 changes: the endpoint path changed from `/v1.2/app/list/` to `/v1.3/app/list/`, request parameter types for `advertiser_id` and `app_platform_ids` changed from number to string, and the response renamed `is_skan_allowed` to `skan_allowed` and added `self_attribution_enabled` and `advanced_dedicated_campaign_allowed`.

• App Optimization Event Get

  Gets app optimization/conversion event information for an app via `/v1.3/app/optimization_event/`. This endpoint returns the available app conversion events based on the advertiser, app, objective, optimization goal, placement settings, and SKAN usage. By using Events API endpoints, you agree to the TikTok Business Products (Data) Terms (https://ads.tiktok.com/i18n/official/policy/business-products-terms) and must not share sensitive data with TikTok. This page also notes the v1.2 to v1.3 migration: the path changed from `/v1.2/app/external_action/` to `/v1.3/app/optimization_event/`, `is_dedicated` became `is_skan`, `optimize_goal` became `optimization_goal`, and `advertiser_id` and `app_id` changed from number to string.

• Auth Advertiser Get

  Get authorized ad accounts.

• Catalog Feed Get

  Gets information about a specific catalog feed or, if `feed_id` is omitted, all feeds under a catalog. Endpoint: `/open_api/v1.3/catalog/feed/get/`. Compared with v1.2, v1.3 uses string types for request parameters `bc_id`, `catalog_id`, and `feed_id`, and returns `feed_id` as a string.

• Catalog Get

  Gets information about a specific catalog or all catalogs under a Business Center using /open_api/v1.3/catalog/get/. In v1.3, the endpoint path changed from /v1.2/catalog/get/ to /v1.3/catalog/get/, `bc_id` and `catalog_id` changed from number to string in both request and response, the response field `name` was renamed to `catalog_name`, and new response fields `ad_creation_eligible` and `additional_config_list` were added.

• Catalog Overview Get

  Gets a catalog overview with counts of products in different audit statuses, including approved, rejected, and processing. In v1.3, the endpoint path is /v1.3/catalog/overview/ and the request parameter types for `bc_id` and `catalog_id` changed from number to string compared with v1.2.

• Catalog Product Get

  Gets products from a product catalog. You can filter by `product_ids`, `sku_ids`, `product_set_ids`, or `conditions`, and sort by product availability or custom sort conditions. When `product_ids` or `sku_ids` is provided, `order` and `conditions` are ignored. In v1.3, `bc_id` and `catalog_id` are strings; earlier v1.2 numeric parameter names/types changed to string-based `product_ids`, `product_set_ids`, and `case_sensitive`-style filtering.

• Catalog Set Get

  Gets either all product sets in a catalog under your Business Center or one specific product set. If `product_set_id` is omitted, the API returns the full list of product sets for the specified `catalog_id`; if provided, it returns only that product set. In v1.3, `bc_id` and `catalog_id` changed from number to string, `set_id` was renamed to `product_set_id` and changed from number to string, and `return_product_count` was added.

• Catalog Video Package Get

  Gets information about all catalog video packages, or a specific catalog video package, under a Business Center. In v1.3, the endpoint path changed from /v1.2/catalog/video/get/ to /v1.3/catalog/video_package/get/, the request parameter name changed from `dpa_video_package_id` to `shopping_ads_video_package_id`, and `bc_id` and `catalog_id` changed from number to string.

• Creative Portfolio List Get

  Retrieves creative portfolios created under an ad account. You can filter by creative portfolio type or by creative portfolio ID. If `filtering` is omitted, the endpoint returns all creative portfolio types under the advertiser except CTA portfolios. Supported portfolio types include Display Card, Website info card, Download Card, Inventory Card, Product Card, Product Tiles, Countdown Sticker, Gift Code Sticker, Pop-up Showcase, Gesture, and Superlike portfolios.