TikTok for Business
Marketing/Ads API connector for TikTok for Business — manage advertisers, identities, campaigns, ad groups, and ads; run reporting; manage custom audiences, creative libraries (images/videos), pixels and pixel events; and read Business Center data.
Categories: Advertising, Marketing
📝 Beta: This connector is in beta. It follows the service's documented API but has not yet been fully tested against the live service, so some tools may behave differently than described.
What you can ask
- List the active campaigns for advertiser
7012345678901234567with their budgets - Pull spend, impressions, and conversions for each ad group over the last 7 days
- Pause every ad group with a cost per conversion above $30
Set up
TikTok for Business connects with credentials from your TikTok for Business account. Have these values ready:
- Environment
- App ID
- Advertiser ID
- Access token
- App secret
- Go to Organization > Connectors and find TikTok for Business.
- Click Enable and choose which tools to allow.
- Each member enters their own values the first time they use it.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
Tools
TikTok for Business offers 41 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (19)
View and search information without changing it.
| Tool | What it does |
|---|---|
get_advertiser_info | Get detailed account info (name, company, currency, timezone, status) for one or more advertiser IDs. |
get_custom_audiences | Get details for specific custom audiences by ID. |
get_image_info | Get info for specific image IDs (max 100). |
get_pixel_event_stats | Get pixel event statistics for up to 10 pixels over a UTC date range (start_date/end_date 'YYYY-MM-DD', span <= 30 days). |
get_report | Run a synchronous integrated report for an advertiser. |
get_video_info | Get info for specific video IDs. |
list_adgroups | List ad groups for an advertiser with pagination. |
list_ads | List ads for an advertiser with pagination. |
list_authorized_advertisers | List advertiser (ad account) IDs the access token is authorized to manage. |
list_bc_assets | List assets (advertiser accounts, catalogs, pixels, etc.) a user can access under a Business Center. |
list_bc_members | List members of a Business Center. |
list_business_centers | List the Business Centers the access token can access, with pagination. |
list_campaigns | List campaigns for an advertiser with pagination. |
list_custom_audiences | List custom audiences for an advertiser with pagination. |
list_identities | List identities (posting entities used when creating ads) for an advertiser. |
list_pixels | List pixels for an advertiser with pagination. |
search_images | Search an advertiser's image library. |
search_videos | Search an advertiser's video library. |
validate_credential | Validate TikTok for Business credentials by listing the advertisers the access token can manage. |
Write (10)
Create or send data.
| Tool | What it does |
|---|---|
create_ad | Create an ad under an ad group. |
create_adgroup | Create an ad group under a campaign. |
create_campaign | Create a campaign under an advertiser. |
create_lookalike_audience | Create a lookalike audience from a source custom audience. |
create_pixel | Create a pixel for an advertiser. |
create_pixel_event | Create events on a pixel. |
create_rule_audience | Create a rule-based (engagement) custom audience. |
share_custom_audiences | Share custom audiences to other advertiser accounts. |
upload_image | Upload an image to the advertiser's library from a public URL (upload_type UPLOAD_BY_URL). |
upload_video | Upload a video to the advertiser's library from a public URL (upload_type UPLOAD_BY_URL). |
Delete or overwrite (12)
Remove or replace existing data.
| Tool | What it does |
|---|---|
delete_custom_audiences | Permanently delete custom audiences by ID. |
unshare_custom_audiences | Stop sharing a custom audience with an advertiser account. |
update_ad | Update an ad incrementally (only the fields you pass change). |
update_ad_status | Enable, disable (pause), or delete an ad. |
update_adgroup | Update an ad group's name, budget, bid, or schedule. |
update_adgroup_budget | Update an ad group's budget. |
update_adgroup_status | Enable, disable (pause), or delete an ad group. |
update_campaign | Update a campaign's name, budget_mode, or budget. |
update_campaign_status | Enable, disable (pause), or delete a campaign. |
update_custom_audience | Update a custom audience (currently its name). |
update_pixel | Update a pixel's name. |
update_pixel_event | Update a pixel event's name/conversion fields. |