TikTok Ads

Retrieves the Custom Conversions associated with an event source, which can be either a Pixel or an App, via `/open_api/v1.3/custom_conversion/list/`.

Gets all audiences for an advertiser, including both owned and shared audiences. Results are paginated, with a maximum page size of 100, and each audience includes basic metadata such as ID, name, type, creation time, and expiration time. Use `is_creator` to determine whether the advertiser owns a returned audience. For more detailed audience information such as current status and modification record, use `/dmp/custom_audience/get/` instead. In v1.3, `advertiser_id` changed from number to string, `custom_audience_ids` was added, and response fields were updated including `type` to `audience_type` and `audience_id` to string.

Gets the details of Saved Audiences associated with an ad account. You can optionally filter the results by specific Saved Audience IDs.

Search image creatives in an advertising account's Asset Library via /v1.3/file/image/ad/search/. Results are limited to the first 10,000 images, ordered by `modify_time`. Compared with v1.2, this v1.3 endpoint changes `advertiser_id` from number to string.

Gets the list of music available for video creation or Carousel Ads creation from both the advertiser's uploaded music and the Audio Library (Commercial Music Library) at /open_api/v1.3/file/music/get/. For Audio Library music, TikTok recommends caching results and refreshing monthly because the library does not update frequently. Copyright notice: music provided by TikTok can only be used for creatives served on TikTok; you must not download, distribute, make available, or perform the video or embedded music on other media unless you separately obtain permission from the rights holders.

Gets the list of identities under an ad account from /open_api/v1.3/identity/get/. You can filter results by identity type or display name. In v1.3, the endpoint path changed from /v1.2/identity/get/ to /v1.3/identity/get/, `advertiser_id` changed from number to string, and the response field `list` was renamed to `identity_list`.

Gets all TikTok posts under an identity through `/open_api/v1.3/identity/video/get/`. In v1.3, `advertiser_id` and `cursor` are strings, `item_type` was added, and response fields changed from v1.2 including `list` to `video_list`, `id` to `anchor_id`, string `item_id`, and new `carousel_info`. Depending on the identity type, pagination behavior differs: for `TT_USER` and `BC_AUTH_TT`, the response `cursor` is the time value of the last returned item; for `AUTH_CODE`, the response `cursor` is a pagination cursor used when `has_more` is `true`.

Gets page IDs and page records from /open_api/v1.3/page/get/ so you can use the returned `page_id` in ads. Retrieve pages either under an ad account by passing `advertiser_id`, or under a Business Center form library by passing `library_id`. This page also notes the v1.2 to v1.3 migration changes: the endpoint path changed from `/v1.2/pages/get/` to `/v1.3/page/get/`, and several request and response ID/time fields changed from number to string types in v1.3.

Gets a paginated list of pixels for an advertiser, with optional filtering by pixel code, pixel ID, name, sort order, and catalog-bindable status. The returned data includes pixel information and Pixel Events. By using Events API endpoints, you agree to the TikTok Business Products (Data) Terms and must not share sensitive data with TikTok. This is the v1.3 endpoint `/open_api/v1.3/pixel/list/`; compared with v1.2, `advertiser_id` and `pixel_id` are strings, and v1.3 adds the `filtering` and `available_for_catalog_only` request parameters. If you need to bind a pixel to a catalog as an event source, use `/catalog/eventsource/bind/`.

Run a synchronous integrated report and return report data immediately from `/open_api/v1.3/report/integrated/get/`. This endpoint can return reporting data for up to 20,000 advertisements. If the advertiser has more than 20,000 ads, use `campaign_ids`, `adgroup_ids`, or `ad_ids` as filters to retrieve all data in batches; you can pass up to 100 IDs at a time when using those filters. If you compare this synchronous report with a report downloaded from TTAM (TikTok Ads Manager), data may be inconsistent because TTAM downloaded reports should be compared with asynchronous reports instead; TTAM downloaded reports and the API asynchronous report do not implement the 20,000-truncation for ads.

Creates an Upgraded Smart+ ad with creatives, text, landing destinations, catalog settings, and tracking settings via `/open_api/v1.3/smart_plus/ad/create/`. You can create at most 30 ads within one Upgraded Smart+ Ad Group. Important deprecation: creating non-Spark Ads using Custom Identities in ad groups that deliver to Automatic Placement or Select Placement when TikTok is included is no longer supported for existing ad accounts. All new ad accounts created on or after January 15, 2026 cannot create non-Spark Ads using Custom Identities for these placements. Existing ads remain unaffected and editable. Campaigns delivering only to Pangle or Global App Bundle placements are not affected. Relevant prerequisites and dependent resources may need to be obtained from `/smart_plus/adgroup/get/`, `/app/list/`, `/app/info/`, `/offline/get/`, and other referenced endpoints.

Retrieves Upgraded Smart+ ads in an ad account from `/open_api/v1.3/smart_plus/ad/get/`. Important: this endpoint returns only creatives that you explicitly selected. Automatically added creatives are not included, including TikTok creator content, creator content from TikTok One, Content Suite, authorized TikTok posts, your own content or previously used content from linked TikTok accounts and Creative Library, and content generated for you such as remixed app store page images. To retrieve all creatives in a campaign, including automatically added creatives, use `/ad/get/`.

Enables, pauses, or deletes Upgraded Smart+ Ads by updating their operation status. Use POST /open_api/v1.3/smart_plus/ad/status/update/. Deleted ads, or ads that belong to deleted campaigns or deleted ad groups, cannot have their status modified.

Updates an Upgraded Smart+ Ad via `/open_api/v1.3/smart_plus/ad/update/`. This endpoint supports incremental updates overall, but `creative_list`, `ad_configuration.product_info`, and `ad_configuration.product_info.promo_info_list` use full-replacement update mode, so when updating any field inside them you must resubmit the complete value or sibling data will be lost. Updating `product_info` or `promo_info_list` triggers ad review again. Important deprecation notice: creating non-Spark Ads using Custom Identities in ad groups that deliver to Automatic Placement or Select Placement when TikTok is included is no longer supported for existing ad accounts. All new ad accounts created on or after January 15, 2026 cannot create non-Spark Ads using Custom Identities for these placements. Existing ads remain unaffected and editable. Ad campaigns that deliver only to Pangle or Global App Bundle placements are not affected by this Custom Identity deprecation. Migrate guidance: https://business-api.tiktok.com/portal/docs?id=1848048566169730

Updates budgets for one or more Upgraded Smart+ ad groups via `/open_api/v1.3/smart_plus/adgroup/budget/update/`. Use `budget` for immediate budget changes, or `scheduled_budget` to configure scheduled budget changes. Either `budget` or `scheduled_budget` must be set. Immediate budget changes take effect right away. Scheduled budget changes are an allowlist-only feature; contact your TikTok representative for access. Scheduled changes take effect from 00:00 a.m. the following day in the ad account's time zone.

Creates an Upgraded Smart+ ad group via POST `/open_api/v1.3/smart_plus/adgroup/create/`. You can create up to 30 ad groups within one Upgraded Smart+ campaign. Campaign-level constraints apply across sibling ad groups: if CBO is enabled (`budget_optimize_on=true`), the following settings, if specified, must be the same across all ad groups in the campaign: `promotion_type`, `promotion_target_type`, `optimization_goal`, `optimization_event`, `billing_event`, `bid_type`, `bid_price`, `conversion_bid_price`, `deep_bid_type`, `vbo_window`, `roas_bid`, and `identity_id`, `identity_type`, `identity_authorized_bc_id`, `native_series_id` when `promotion_type` is `NATIVE_SERIES`. If CBO is disabled (`budget_optimize_on=false`), `bid_type`, `deep_bid_type`, `vbo_window`, and `budget_mode` must be the same across all ad groups in the campaign. The endpoint also includes allowlist-only capabilities such as gaming compliance agreement, deep funnel optimization with CRM events, ad-group-level TikTok account selection for direct messaging ads, some VBO scenarios, theatrical-release promotion settings, and Goal-based budget increase.

Retrieves Upgraded Smart+ ad groups within an ad account from /open_api/v1.3/smart_plus/adgroup/get/. You can return all fields by omitting `fields`, and filter results by campaign, ad group, status, objective, sales destination, promotion type, and optimization goal. This endpoint references campaign IDs from /smart_plus/campaign/get/.

Enables, pauses, or deletes Upgraded Smart+ ad groups using /smart_plus/adgroup/status/update/. You can update 1-20 ad groups per request. Deleted ad groups, and ad groups that belong to deleted campaigns, cannot have their status modified.

Updates an Upgraded Smart+ ad group via `/open_api/v1.3/smart_plus/adgroup/update/`. This endpoint supports incremental updates. Use `/smart_plus/adgroup/get/` to obtain the `adgroup_id` before updating. Some settings have campaign-wide effects or constraints: updating `bid_price`, `conversion_bid_price`, or `roas_bid` on one ad group automatically updates the corresponding bidding value for all other ad groups in the same campaign, and when Campaign Budget Optimization (CBO) is enabled (`budget_optimize_on=true`) these settings, if specified, must be the same across all ad groups in that campaign. The docs also include allowlist-only features such as postal code targeting in Brazil, Indonesia, Thailand, and Vietnam; `spc_audience_age=ALL`; and Goal-based budget increase (`budget_auto_adjust_strategy=AUTO_BUDGET_INCREASE`).

Creates an Upgraded Smart+ campaign via `/open_api/v1.3/smart_plus/campaign/create/`. The endpoint supports `APP_PROMOTION`, `WEB_CONVERSIONS`, and `LEAD_GENERATION` objectives, including iOS 14 dedicated campaigns and catalog-enabled web/app sales flows. Retain key setup constraints when building the payload: some features are allowlist-only, including Mini Series catalog ads, promotional campaign settings, Goal-based budget increase, RTA, RTA bid, disabling SKAN attribution, and the gaming compliance agreement. Some fields are immutable after creation, including `sales_destination`, `is_promotional_campaign`, `budget_mode`, `rta_id`, `rta_bid_enabled`, `rta_product_selection_enabled`, and `postback_window_mode` once set. Cross-API prerequisites may apply: fetch app IDs from `/app/list/`, and if you use `postback_window_mode`, you can also manage disable flows with `/smart_plus/campaign/status/update/`. For iOS dedicated campaigns, the promoted app must have SAN enabled; for SKAN 4.0 postback settings, the app must have SKAN 4.0 enabled.

Retrieves Upgraded Smart+ campaigns in an ad account from `/open_api/v1.3/smart_plus/campaign/get/`, with optional pagination, field selection, and filtering.

Enables, pauses, or deletes Upgraded Smart+ campaigns through `/smart_plus/campaign/status/update/`. For Dedicated Campaigns (`campaign_type=IOS14_CAMPAIGN`), you can also configure `postback_window_mode` when disabling campaigns to secure SKAN 4.0 postbacks. This SKAN setting applies only if the campaign is a Dedicated Campaign, `operation_status` is `DISABLE`, `postback_window_mode` has not already been configured for the campaign, and SKAN 4.0 is enabled for the app. If eligible Dedicated Campaigns are mixed with ineligible campaigns, the postback window configuration can be partially successful: ineligible campaigns are ignored and their `postback_window_mode` is not changed. Deleted campaigns cannot be modified.

Updates an Upgraded Smart+ campaign via `/smart_plus/campaign/update/`. This endpoint supports incremental updates. Goal-based budget increase (`budget_auto_adjust_strategy=AUTO_BUDGET_INCREASE`) is allowlist-only; contact your TikTok representative for access. To obtain campaign IDs before updating, use `/smart_plus/campaign/get/`.

Executes a TikTok API tool by name. The tool_name comes from tool_list / tool_get. The server looks up the api_url and http_method from the consolidated registry, injects advertiser_id (if supplied), merges params, and calls TikTok directly. The raw TikTok response is returned. No client-side validation: TikTok's own error responses surface unchanged.

Returns the full definitions for one or more tools selected by tool_name_list, including each tool's description, api_url, http_method, and inputSchema. Call tool_list first to discover available tool names, then call tool_get with the specific tool names you want to inspect.

Lists every TikTok API tool reachable via the dispatcher, organised by object group. Each group entry has a one-line description plus a minimal { tool_name: tool_summary } map so you can discover candidate tool names without loading full schemas for an entire group. When a tool_summary is unavailable, the value falls back to the api_path. Tools already registered natively at L0 do NOT appear here — they are callable directly by their alias. After choosing a tool name, call tool_get(tool_name_list) to fetch that single tool's full definition.