TikTok Ads tools

Tools for the TikTok Marketing API: campaign/ad group/ad management, video & image creative upload, interest/location targeting, pixel & lookalike audiences.

Connection & Account · 4

connect_tiktok_adsfree

Generates a one-time authorization link to connect a TikTok (TikTok for Business) ad account.

list_tiktok_ad_accounts1 credits

Lists the user's connected TikTok ad account(s).

all_accessible

list_tiktok_bc_advertisers1 credits

Lists the ad accounts (advertisers) under a Business Center.

bc_id

list_tiktok_business_centers1 credits

Lists the accessible TikTok Business Centers (agency multi-account management).

Reading & Reports · 7

list_tiktok_adgroups1 credits

Lists TikTok ad groups; if campaign_id is provided, limits to that campaign.

advertiser_idcampaign_id

list_tiktok_ads1 credits

Lists TikTok ads; if adgroup_id is given, limits to that ad group.

advertiser_idadgroup_id

list_tiktok_audiences1 credits

Lists TikTok custom + lookalike audiences (for ad group targeting).

advertiser_id

list_tiktok_campaigns1 credits

Lists the campaigns in a TikTok ad account (advertiser_id).

advertiser_id

list_tiktok_identities1 credits

Lists TikTok ad identities — the identity_id needed when creating ads is obtained here (the equivalent of Meta's page_id).

advertiser_id

list_tiktok_pixels1 credits

Lists TikTok conversion pixels (for measurement + WEB_CONVERSIONS/CONVERT optimization).

advertiser_id

tiktok_campaign_report2 credits

TikTok performance report (spend/impressions/clicks/CTR/conversions...).

advertiser_idstart_dateend_datedata_levelbreakdown

Targeting · 2

tiktok_region_search1 credits

Searches TikTok geo-targeting location IDs (location_id) — for the required location_ids field in create_tiktok_adgroup.

advertiser_idkeywordobjective_type

tiktok_targeting_search1 credits

Searches TikTok interest/behavior targeting categories → returns id + name (used as interest_category_ids in create_tiktok_adgroup).

advertiser_idkeywordkind

Campaign · 4

create_tiktok_campaign8 credits

Creates a TikTok campaign.

advertiser_idnameobjective_typebudget_modebudgetconfirm

update_tiktok_campaign5 credits

Renames a TikTok campaign.

advertiser_idcampaign_idnameconfirm

update_tiktok_campaign_budget5 credits

Updates a TikTok campaign budget (in the main unit of the account currency, e.g.

advertiser_idcampaign_idbudgetconfirm

update_tiktok_campaign_status5 credits

Enable/pause/delete TikTok campaign(s).

advertiser_idcampaign_idsoperationconfirm

Ad group · 3

create_tiktok_adgroup8 credits

Creates a TikTok ad group — targeting/budget/billing event.

advertiser_idcampaign_idnamelocation_idsoptimization_goalbilling_eventbudget_modebudgetage_groupsgendersinterest_category_idsaudience_idsexcluded_audience_idspixel_id

update_tiktok_adgroup_budget5 credits

Updates a TikTok ad group budget (in the main unit of the account currency).

advertiser_idadgroup_idbudgetconfirm

update_tiktok_adgroup_status5 credits

Enable/pause/delete one or more TikTok ad groups.

advertiser_idadgroup_idsoperationconfirm

Creative & Ad · 5

create_tiktok_ad8 credits

Creates a TikTok ad (within an ad group).

advertiser_idadgroup_idnameidentity_idad_textlanding_page_urlvideo_idimage_idscall_to_actiondisplay_nameauto_message_idtiktok_item_ididentity_typeconfirm

create_tiktok_lookalike_audience6 credits

Creates a TikTok lookalike audience from a source custom audience.

advertiser_idnamesource_audience_idlocation_idsaudience_sizeconfirm

update_tiktok_ad_status5 credits

Enable/pause/delete TikTok ad(s).

advertiser_idad_idsoperationconfirm

upload_tiktok_image2 credits

Uploads a TikTok image creative from a public URL → image_id.

advertiser_idimage_urlfile_nameconfirm

upload_tiktok_video3 credits

Uploads a TikTok video creative from a public URL → returns video_id (used in create_tiktok_ad).

advertiser_idvideo_urlfile_nameconfirm

Other

create_tiktok_auto_messagefree

Creates a TikTok WELCOME-CHAT (automated message) template: the greeting a user sees the moment they tap a Direct Message ad, plus optional tappable 'suggested question → automatic answer' pairs (e.g.

advertiser_idtitlecontentsuggested_questionsconfirm

create_tiktok_customer_file_audience6 credits

Creates a TikTok custom audience from a CUSTOMER LIST (retarget your CRM contacts / build a lookalike seed).

advertiser_idnameidentifiersid_typeconfirm

create_tiktok_identityfree

Creates a TikTok AD IDENTITY — the brand name and avatar shown on the ad.

advertiser_iddisplay_nameimage_uriconfirm

create_tiktok_pixelfree

Creates a TikTok conversion PIXEL.

advertiser_idnameconfirm

download_tiktok_leads2 credits

Downloads the actual leads collected by TikTok lead-gen or messaging ads, with each lead's answered fields.

advertiser_idlead_sourcepage_idad_idstart_dateend_datelimit

get_tiktok_lead_form_fields1 credits

Returns the question/field schema of a TikTok lead instant form (field key, label and type) so the answers in download_tiktok_leads can be interpreted.

advertiser_idpage_id

list_tiktok_asset_groups1 credits

Lists the asset groups in a TikTok Business Center (groupings of advertisers / pixels / identities used for bulk permissioning).

bc_id

list_tiktok_auto_messagesfree

Lists the TikTok WELCOME-CHAT (automated message) templates on the account — the auto_message_id that TikTok REQUIRES on every Direct Message / messaging ad.

advertiser_id

list_tiktok_bc_pixels1 credits

Lists every pixel across a TikTok Business Center (cross-account measurement view).

bc_id

list_tiktok_creative_portfolios1 credits

Lists the account's creative portfolios (named collections of creative assets).

advertiser_id

list_tiktok_gmv_max_stores1 credits

Lists the TikTok Shop stores linked to the ad account — these are what GMV Max (TikTok Shop e-commerce) campaigns run against.

advertiser_id

list_tiktok_lead_forms1 credits

Lists the account's TikTok LEAD-GEN instant forms — each with the page_id that download_tiktok_leads needs, plus the form title, status and creation time.

advertiser_id

list_tiktok_postsfree

Lists the ORGANIC TIKTOK POSTS of a connected TikTok account (identity) that can be turned into ads — Spark Ads.

advertiser_ididentity_ididentity_typelimit

list_tiktok_smart_plus1 credits

Lists the account's Smart+ (TikTok's automated 'smart performance') campaigns, ad groups or ads — these do NOT appear in list_tiktok_campaigns/adgroups/ads, which only cover standard (manual) objects.

advertiser_idlevel

list_tiktok_videosfree

Lists the ad account's VIDEO LIBRARY — every video material uploaded to TikTok Ads, newest first, with the video_id that create_tiktok_ad requires (plus file name, duration, size and a preview link).

advertiser_idlimit

manage_tiktok_search_negative_keywords4 credits

Manages negative keywords on TikTok SEARCH ads.

advertiser_idobject_typeobject_idoperationkeywordskeyword_idsmatch_typeconfirm

send_tiktok_conversion_eventfree

SENDS A SERVER-SIDE CONVERSION EVENT to TikTok (Events API) — the fix for conversions lost to ad-blockers, iOS restrictions and cookie limits.

advertiser_idpixel_codeevent_nameemailphoneexternal_idvaluecurrencyevent_idurlttclidtest_event_codeconfirm

share_tiktok_audience4 credits

Shares (or un-shares) TikTok custom audiences with other ad accounts under the SAME Business Center — e.g.

advertiser_idaudience_idsshared_advertiser_idsactionconfirm

tiktok_advertiser_qualification1 credits

Returns an advertiser's qualification / verification status under a Business Center (business verification, industry qualification, account standing).

bc_idadvertiser_id

tiktok_change_history2 credits

Business-Center-scoped change log — who changed what and when (audit trail) across the BC's ad accounts.

bc_idadvertiser_idstart_dateend_datelimit

tiktok_recommendations2 credits

TikTok's own automatic optimization suggestions for an ad account (the equivalent of Google Ads recommendations) — budget, bidding, targeting, creative and setup improvements TikTok recommends applying.

advertiser_idlevel

update_tiktok_adfree

UPDATES a TikTok ad's CREATIVE in place — the ad text, landing page, call-to-action or display name.

advertiser_idadgroup_idad_idad_namead_textlanding_page_urlcall_to_actiondisplay_nameconfirm

update_tiktok_adgroupfree

UPDATES a TikTok ad group's TARGETING, BID and SCHEDULE in place.

advertiser_idadgroup_idnamebid_pricelocation_idsage_groupsgendersinterest_category_idsaudience_idsexcluded_audience_idsschedule_startschedule_endbid_typepacing