TikTok for Business

Estimates audience size for a targeting configuration similar to ad group creation using /open_api/v1.3/ad/audience_size/estimate/. In v1.3, `objective_type` and `optimization_goal` are required. Due …

Creates regular ads by uploading ad creatives such as images, videos, text, and call-to-action settings to /open_api/v1.3/ad/create/. Creative requirements vary by placement. Each ad group can contain…

Gets regular ads and Smart Creative ads. To retrieve creative materials for Smart Creative ads, use `/ad/aco/get/`. Deleted ads are excluded by default; to include them, set `primary_status` to `STATU…

Appeals a rejected ad group and requests re-evaluation after review rejection. After submitting an appeal, wait for processing and call /adgroup/review_info/ to check the appeal status and updated rev…

Updates the lifetime budgets of one or more ad groups, or schedules changes to the daily budgets or dynamic daily budgets of one or more ad groups, via `/open_api/v1.3/adgroup/budget/update/`. Schedul…

Creates an ad group under an existing campaign at /open_api/v1.3/adgroup/create/. Use it to configure placement, audience targeting, budget, schedules, and bidding/optimization settings. Before migrat…

Gets detailed information for one or more ad groups from `/open_api/v1.3/adgroup/get/`. You can limit returned data with `fields` and filter results by campaign ID, objective, ad group ID, ad group na…

Gets the dynamic quota for the number of active auction ad groups an advertiser can have. If the advertiser is subject to a fixed active ad group quota, the response returns `total_adgroup_quota` = 50…

Gets ad group review information, including approval status, rejection reasons, and suggestions so you can fix rejected ad groups before deployment. In v1.3, `advertiser_id` and `adgroup_ids` are stri…

Creates a Reach & Frequency ad group via `/open_api/v1.3/adgroup/rf/create/`. This endpoint is part of the Reach & Frequency workflow and relies on campaign-level setup described in the Reach & Freque…

Queries estimated daily cost and frequency distribution for Reach & Frequency ad groups via /open_api/v1.3/adgroup/rf/estimated/info/. If an ad group does not have a valid estimate, no corresponding r…

Updates a Reach & Frequency ad group via /open_api/v1.3/adgroup/rf/update/. The target ad group must belong to a campaign whose `objective_type` is `RF_REACH`. Compared with v1.2, v1.3 changes the pat…

Enables, disables, or deletes ad groups through `/open_api/v1.3/adgroup/status/update/`. Use it to resume delivery, pause delivery, or delete ad groups. Ad groups in Dedicated Campaigns cannot be dele…

Updates an ad group via `POST /open_api/v1.3/adgroup/update/`. Not all ad group settings are editable after creation (for example, placement). This endpoint uses full-replacement update mode, not incr…

Gets ad review information for one or more ads. Use GET https://business-api.tiktok.com/open_api/v1.3/ad/review_info/ with `advertiser_id` and `ad_ids` to retrieve approval and review-status details f…

Enable, disable, or delete one or more ads by updating their operation status. The status of a deleted ad, or an ad in a deleted ad group or deleted campaign, cannot be modified. You can check current…

Updates creatives for regular ads, including call-to-action, ad name, text, image, and video material, via `POST /open_api/v1.3/ad/update/`. For Smart Creative ads, use `/ad/aco/update/`. Incremental …

Gets the balance of ad accounts in a Business Center and, for ad accounts owned by the Business Center in auto-allocation mode, their budget information. Only ad accounts for which the Business Center…

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 `A…

Gets ad account transaction records in a Business Center. Only returns records for ad accounts that the Business Center has administrator rights over. Both Agency and Direct Business Centers can perfo…

Updates ad accounts created in Business Centers via /open_api/v1.3/advertiser/update/. You can update non-budget settings for a single ad account by passing `advertiser_id`, or update budget settings …

Creates a mobile app in Events API at `/v1.3/app/create/`. The created app can be used to create ads. By using Events API endpoints, you agree to the TikTok Business Products (Data) Terms and must not…

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/polic…

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 t…

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, op…

Retrieves app retargeting optimization events for a specified app. The returned events can be used to define Audience Rules; see https://ads.tiktok.com/marketing_api/docs?id=1739566532187138. By using…

Updates a mobile app in Events API. You can modify app details such as download links and third-party tracking links. In v1.3, use `/open_api/v1.3/app/update/`; `partner` replaces `partner_id`, and bo…

Checks an asset's ad-binding quota: how many ads the asset is already bound to and how many additional ads it can still be bound to. Each asset can only be used to create a limited number of ads. In v…

Gets potential audience insight details for an advertiser from /open_api/v1.3/audience/insight/info/. You must send either `locations` or `custom_audience_id`. If `custom_audience_id` is provided, `se…

Gets audience overlap details between one benchmark TikTok Custom Audience and up to four comparison Custom Audience segments for the specified advertiser. Custom audience IDs provided in this request…

Creates or deletes an audience segment through the Streaming API endpoint `/open_api/v1.3/segment/audience/`. Access is allowlist-only: to apply for Streaming API access (formerly Segment API), use th…

Lists all TikTok ad accounts (advertisers) the current access token is authorized to manage, returning each account's advertiser_id and name. Call this first (no parameters needed) whenever you need a…

Retrieves the budget change history for an ad account within a Business Center. Only Business Center members with the Finance Manager or Finance Analyst role can access this history. To configure or u…

Retrieves cost records at the ad account and Business Center levels for a specified Business Center. Only members with the Finance Manager or Finance Analyst role can retrieve Business Center cost rec…

Retrieves transaction records for a Business Center, its ad accounts, or its Payment Portfolio from /open_api/v1.3/bc/account/transaction/get/. You must have a Finance role on the Business Center (Fin…

Retrieves the currency codes and registration-area location codes for ad accounts within a Business Center. Use the returned values as valid inputs for the `registered_area` and `currency_of_account` …

Creates an ad account in a Business Center via `/open_api/v1.3/bc/advertiser/create/`. You must be an Admin user of the Business Center. To create auction ad accounts, set `advertiser_info.type` to `A…

Disables an ad account in Business Center via `/open_api/v1.3/bc/advertiser/disable/`. You must be an Admin user of the Business Center. Disable an account only when you no longer want to use it: once…

Retrieves existing qualifications within a Business Center from `/bc/advertiser/qualification/get/`. The returned `qualification_id` can be reused when creating an ad account by passing it to the `qua…

Checks whether UnionPay verification is required for a business license. For ad accounts registered in the Chinese Mainland and belonging to these business types, UnionPay verification must be complet…

Generates an authorization URL that a Business Center can share with a TikTok account owner to request ad delivery permissions for that TikTok account. After obtaining the URL, generate a QR code from…

Deletes assets from a Business Center via /v1.3/bc/asset/admin/delete/. You must be an Admin user of the Business Center. Supported asset types are leads and TikTok accounts. In v1.3, `asset_ids` must…

Gets additional information about assets in a Business Center for Business Center Admin users. You can also filter results by ad account display status, relation type between the Business Center and t…

Links a TikTok account asset to an ad account in a Business Center using /open_api/v1.3/bc/asset/advertiser/assign/. After the link is created, Business Center members who have access to the linked ad…

Retrieves the list of ad accounts linked to a TikTok account in a Business Center. Once an ad account is linked to a TikTok account in a Business Center, Business Center members who have access to the…

Unlinks a TikTok account from an ad account in a Business Center using `/open_api/v1.3/bc/asset/advertiser/unassign/`. After the linkage is removed, Business Center members who have access to the ad a…

Assigns a Business Center asset to a TikTok For Business user who already belongs to the same Business Center. You must be an Admin user of the Business Center to call this endpoint. In v1.3, the endp…

Gets Business Center assets that the authorized user, or a specified user, has access to. Endpoint: /v1.3/bc/asset/get/. In v1.3, `bc_id` changed from number to string, `asset_id` in the response chan…

Creates an Asset Group in a Business Center at `/open_api/v1.3/bc/asset_group/create/`. The caller must be an Admin user of the Business Center.

Deletes Asset Groups from your Business Center via `/open_api/v1.3/bc/asset_group/delete/`. You must be an Admin user of the Business Center to use this endpoint. Deleting an Asset Group removes membe…