Documentation / Référence des outils

Outils TikTok Ads

Outils pour la TikTok Marketing API : gestion des campagnes, groupes d'annonces et annonces, import de créations vidéo et image, ciblage par centres d'intérêt et par zone, pixel et audiences similaires.

Connexion et compte · 4

connect_tiktok_adsgratuit

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

list_tiktok_ad_accounts1 crédits

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

all_accessible

list_tiktok_bc_advertisers1 crédits

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

bc_id

list_tiktok_business_centers1 crédits

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

Lecture et rapports · 7

list_tiktok_adgroups1 crédits

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

advertiser_idcampaign_id

list_tiktok_ads1 crédits

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

advertiser_idadgroup_id

list_tiktok_audiences1 crédits

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

advertiser_id

list_tiktok_campaigns1 crédits

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

advertiser_id

list_tiktok_identities1 crédits

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 crédits

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

advertiser_id

tiktok_campaign_report2 crédits

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

advertiser_idstart_dateend_datedata_levelbreakdown

Ciblage · 2

tiktok_region_search1 crédits

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

advertiser_idkeywordobjective_type

tiktok_targeting_search1 crédits

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

advertiser_idkeywordkind

Campagne · 4

create_tiktok_campaign8 crédits

Creates a TikTok campaign.

advertiser_idnameobjective_typebudget_modebudgetautomationsales_destinationconfirm

update_tiktok_campaign5 crédits

Renames a TikTok campaign.

advertiser_idcampaign_idnameconfirm

update_tiktok_campaign_budget5 crédits

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

advertiser_idcampaign_idbudgetconfirm

update_tiktok_campaign_status5 crédits

Enable/pause/delete TikTok campaign(s).

advertiser_idcampaign_idsoperationconfirm

Groupe d'annonces · 3

create_tiktok_adgroup8 crédits

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 crédits

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

advertiser_idadgroup_idbudgetconfirm

update_tiktok_adgroup_status5 crédits

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

advertiser_idadgroup_idsoperationconfirm

Création et annonce · 5

create_tiktok_ad8 crédits

Creates a TikTok ad (within an ad group).

advertiser_idadgroup_idnameidentity_idad_textlanding_page_urlvideo_idimage_idscall_to_actiondisplay_nameauto_message_idtiktok_item_ididentity_typeidentity_bc_id

create_tiktok_lookalike_audience6 crédits

Creates a TikTok lookalike audience from a source custom audience.

advertiser_idnamesource_audience_idlocation_idsaudience_sizeconfirm

update_tiktok_ad_status5 crédits

Enable/pause/delete TikTok ad(s).

advertiser_idad_idsoperationconfirm

upload_tiktok_image2 crédits

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

advertiser_idimage_urlfile_nameconfirm

upload_tiktok_video3 crédits

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

advertiser_idvideo_urlfile_nameconfirm

Autres

create_tiktok_auto_messagegratuit

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 crédits

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

advertiser_idnameidentifiersid_typeconfirm

create_tiktok_identitygratuit

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

advertiser_iddisplay_nameimage_uriconfirm

create_tiktok_pixelgratuit

Creates a TikTok conversion PIXEL.

advertiser_idnameconfirm

download_tiktok_leads2 crédits

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 crédits

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 crédits

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

bc_id

list_tiktok_auto_messagesgratuit

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 crédits

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

bc_id

list_tiktok_creative_portfolios1 crédits

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

advertiser_id

list_tiktok_gmv_max_stores1 crédits

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 crédits

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_postsgratuit

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 crédits

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_videosgratuit

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 crédits

Manages negative keywords on TikTok SEARCH ads.

advertiser_idobject_typeobject_idoperationkeywordskeyword_idsmatch_typeconfirm

send_tiktok_conversion_eventgratuit

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 crédits

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 crédits

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

bc_idadvertiser_id

tiktok_change_history2 crédits

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 crédits

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_adgratuit

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_adgroupgratuit

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