TikTok Ads
Connects to the TikTok Marketing API for campaign management and insights. An agent can list campaigns and ad groups, fetch performance reports, and enable or disable campaigns.
Add to an agent node's tools array with _node_type: "tool-tiktok-ads". See Connector Reference — How connectors are used.
Authentication
| Field | Required | Description |
|---|---|---|
access_token | Yes (or token) | TikTok Marketing API access token, sent as the Access-Token header. |
token | Fallback | Used if access_token is not set. |
advertiser_id | Yes | TikTok advertiser account ID. |
{
"name": "tiktok_ads",
"_node_type": "tool-tiktok-ads",
"access_token": "{{ secret.TIKTOK_ACCESS_TOKEN }}",
"advertiser_id": "1234567890123456789"
}
Tools
tiktok_ads_list_campaigns
List TikTok ad campaigns with budget, objective and status.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | CAMPAIGN_STATUS_ENABLE, CAMPAIGN_STATUS_DISABLE (empty = all) |
page | number | No | Page number (default 1) |
Returns: A newline-separated list of [id] name status=... obj=... budget=$... lines, or "No campaigns found.".
tiktok_ads_campaign_report
Get TikTok campaign performance report: impressions, clicks, CTR, conversions, spend, CPM.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id | string | Yes | Campaign ID |
days | number | No | Look-back days (default 7) |
Returns: A multi-line summary with impressions, clicks, CTR, conversions, spend, CPM and CPC for the look-back period, or "No report data for campaign: <id>".
tiktok_ads_list_ad_groups
List TikTok ad groups (targeting, optimization and bid strategy).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id | string | No | Campaign ID (empty = all) |
page | number | No | Page number (default 1) |
Returns: A newline-separated list of [id] name status=... bid_type=... lines.
tiktok_ads_update_campaign_status
Enable or pause TikTok ad campaigns.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_ids | string | Yes | Comma-separated campaign IDs |
status | string | Yes | CAMPAIGN_STATUS_ENABLE or CAMPAIGN_STATUS_DISABLE |
Returns: A status message including a snippet of the TikTok API's raw JSON response (truncated to 200 characters).