- Retrieve a paginated list of ad groups for a TikTok Ads advertiser account via GET /adgroup/get/, with optional filtering by campaign IDs, ad group status, objective type, name, or creation date range, returning full targeting, budget, schedule, placement, and bid configuration for each ad group
- Create a new ad group under an existing TikTok Ads campaign via POST /adgroup/create/, configuring audience targeting (location, demographics, interests, devices), budget and bid strategy, delivery schedule, ad placements, optimization goals, and brand safety settings in a single request
- Partially update an existing TikTok Ads ad group via POST /adgroup/update/, modifying only the fields you include in the request (name, budget, bid strategy, targeting, schedule, dayparting, or social settings) while all omitted fields retain their current values
- Batch enable, disable, or permanently delete up to 20 TikTok Ads ad groups in a single request via POST /adgroup/status/update/, with optional partial success mode to skip ineligible ad groups rather than failing the entire batch
- Update the lifetime budgets of up to 20 ad groups immediately, or schedule daily/dynamic daily budget changes for up to 20 ad groups to take effect the following day at 00:00 in the ad account's time zone, via POST /adgroup/budget/update/
- Retrieve ads (the lowest tier of TikTok's Campaign > Ad Group > Ad hierarchy) via GET /ad/get/ with filtering by campaign, ad group, ad IDs, delivery status, or creation date, returning creative details, review status, and delivery state
- Create up to 20 ads within an existing ad group via POST /ad/create/, each defined as a creative object with ad format, identity profile, ad text, CTA, and optional assets (production only, ads enter TikTok review before delivery)
- Modify an existing ad's creative content, identity, ad text, CTA, or landing page via POST /ad/update/, with optional incremental (patch) update mode for select fields (production only, changes may trigger re-review)
- Batch enable, disable, or permanently delete up to 20 TikTok ads or ACO (Automated Creative Optimization) ads via POST /ad/status/update/ (production only, deleted ads cannot be restored)
- Retrieve comprehensive account profile, status, and configuration details for one or more TikTok Ads advertiser accounts via GET /advertiser/info/, including timezone, currency, role, balance, industry, and business verification status
- List all TikTok Ads advertiser accounts authorized for the authenticated OAuth2 app via GET /oauth2/advertiser/get/. Returns account IDs, names, and statuses. OAuth2 authentication only -- not available with sandbox API keys
- Retrieve all registered mobile apps associated with a TikTok Ads advertiser account via GET /app/list/, returning app IDs, names, platform types (Android/iOS), and download URLs. Required for creating APP_PROMOTION campaigns and configuring app-based ad groups. Production only -- not available on sandbox
- List all custom audiences (both owned and shared) under the advertiser account with pagination, returning audience IDs, names, types, and expiration info
- Retrieve detailed information for specific audiences by their IDs, including processing status, modification history, shared status, and lookalike specifications
- Create a rule-based custom audience by defining inclusion and exclusion rules that target users based on specific actions and behaviors (e.g., ad engagement, app activity, website visits)
- Update the display name of an existing custom audience. Does not modify the audience's matched user data or targeting rules
- Permanently delete one or more custom audiences by their IDs. This action is irreversible and automatically removes the audience from any ad groups currently targeting it
- Create a lookalike audience that finds new users similar to an existing source audience, expanding reach while maintaining targeting relevance. Production only (not available on sandbox)
- Trigger a manual refresh of one or more lookalike audiences to re-analyze the source audience and update the matched users with the latest data. Production only (not available on sandbox)
- Connect or disconnect a custom audience from one or more ad groups for inclusion or exclusion targeting. Production only (not available on sandbox)
- Retrieve a paginated list of all advertising campaigns under a TikTok Ads advertiser account, with optional filtering by campaign IDs, delivery status, objective type, and creation date range via GET /campaign/get/ (TikTok Business API v1.3)
- Create a new advertising campaign under a TikTok Ads advertiser account via POST /campaign/create/, specifying the marketing objective, budget mode, and budget amount. Returns the newly assigned campaign_id for use in subsequent ad group and ad creation
- Partially update an existing TikTok Ads campaign's name, budget amount, or budget mode via POST /campaign/update/. Only explicitly provided fields are modified; omitted fields retain their current values. The campaign must not be in DELETE status
- Batch update the delivery status of one or more TikTok Ads campaigns via POST /campaign/status/update/, supporting ENABLE, DISABLE, and DELETE operations. Disabling a campaign cascades to pause all child ad groups and ads; deleting is permanent and irreversible
- Search and retrieve ad image assets from the advertiser's creative library with optional filtering by image IDs, material IDs, or dimensions
- Search and retrieve ad video assets from the advertiser's creative library with optional filtering by video IDs, material IDs, or dimensions
- Retrieve detailed metadata for one or more uploaded image assets by their IDs, including dimensions, file size, format, and CDN preview URLs
- Retrieve detailed metadata for one or more uploaded video assets by their IDs, including duration, dimensions, processing status, and thumbnail URL
- Upload an image to the advertiser's TikTok Ads creative library from a publicly accessible URL, returning an image_id for use in ad creatives
- Upload a video to the advertiser's TikTok Ads creative library from a public URL or bind an existing TikTok video to the ad account, returning a video_id for use in ad creatives
- Rename a video asset in the advertiser's creative library by specifying its video_id and the new file_name
- Rename an image asset in the advertiser's creative library by specifying its image_id and the new file_name
- Retrieve all identities (public-facing ad profiles) under a TikTok Ads account via GET /identity/get/, with optional filtering by identity type or display name for Spark Ads workflows
- Retrieve detailed profile information for a specific identity via GET /identity/info/, including display name, avatar URL, username, and messaging capabilities (production only, returns error 50000 on sandbox)
- Retrieve video and carousel posts published by a TikTok identity via GET /identity/video/get/, returning item_id values needed for Spark Ads creation (production only, requires a real TikTok account identity)
- Check whether the background music in a TikTok post is licensed for ad use in specified target locations and time period via GET /identity/music/authorization/ (production only, must be called before creating Spark Ads with music)
- Retrieve detailed metadata for one or more TikTok posts (video or carousel) via GET /identity/video/info/, including post content, engagement data, and Spark Ads eligibility (production only)
- Create a CUSTOMIZED_USER identity with a display name and optional avatar via POST /identity/create/, returning an identity_id for use in ad creation (note CUSTOMIZED_USER is deprecated for TikTok placement ads)
- Permanently delete a CUSTOMIZED_USER identity via POST /identity/delete/. Since custom identities cannot be edited, delete and recreate to make changes
- Retrieve a paginated list of TikTok Pixels and their associated event configurations for an advertiser account via GET /pixel/list/, with optional filtering by pixel code, pixel ID, or pixel name (fuzzy match)
- Create a new TikTok Pixel for website conversion tracking via POST /pixel/create/. Returns the pixel_id and pixel_code for embedding in your website JavaScript or using with the Events API for server-to-server event tracking
- Update an existing TikTok Pixel's name, Advanced Matching configuration, first-party cookie settings, and expanded data sharing preferences via POST /pixel/update/. Supports both Manual and Automatic Advanced Matching for improved conversion attribution
- Run a synchronous integrated report via GET /report/integrated/get/ to retrieve ad performance metrics grouped by configurable dimensions (campaign, ad group, ad, or time). Returns up to 20,000 rows per request with support for BASIC, AUDIENCE, CATALOG, and other report types
- Retrieve the full list of targetable geographic regions (countries, states, cities, DMAs) with their TikTok location IDs, filtered by placement and campaign objective. Production only
- Retrieve the full hierarchical taxonomy of interest-based targeting categories with their TikTok category IDs for use in ad group interest targeting. Production only
- Retrieve the full list of available language targeting options with their codes for use in ad group language targeting. Production only
- Retrieve the taxonomy of behavioral action categories for targeting users based on recent in-app actions (video interactions, creator follows, hashtag views). Production only
- Search for targeting options by keyword across multiple categories (geographic locations, interest categories, interest keywords, and purchase intention keywords). Production only
- List available targeting options by type for specific geographic locations, currently supporting ISP (Internet Service Provider) targeting. Production only
- Get AI-recommended interest and behavioral action categories optimized for your campaign objective, placements, and target regions. Production only
- Get recommended interest keywords related to a seed keyword, returning keyword IDs for use in ad group interest keyword targeting. Production only
No matching actions