Menu
TikTok Ads API for advertising campaign management. Use when user mentions "TikTok Ads", "TikTok for Business", "TikTok advertising", ad campaigns, or TikTok ad reporting.
Based on SOC occupation classification
| name | tiktok-ads |
| description | TikTok Ads API for advertising campaign management. Use when user mentions "TikTok Ads", "TikTok for Business", "TikTok advertising", ad campaigns, or TikTok ad reporting. |
TIKTOK_ADS_TOKEN.advertiser_id. Ask the user which ad account to use when it is not clear.https://business-api.tiktok.com/open_api/v1.3.Every request requires this header:
Access-Token: $TIKTOK_ADS_TOKEN
Do not use Authorization: Bearer ... for TikTok Ads requests. TikTok API for Business expects the OAuth token in the Access-Token header.
If requests fail, run zero doctor check-connector --env-name TIKTOK_ADS_TOKEN.
TikTok responses usually include code, message, and request_id. Treat code: 0 as success. Include request_id when summarizing API failures.
curl -sS --get "https://business-api.tiktok.com/open_api/v1.3/campaign/get/" \
--data-urlencode "advertiser_id={advertiser-id}" \
--data-urlencode "page_size=20" \
--header "Access-Token: $TIKTOK_ADS_TOKEN" | jq .
curl -sS --get "https://business-api.tiktok.com/open_api/v1.3/campaign/get/" \
--data-urlencode "advertiser_id={advertiser-id}" \
--data-urlencode 'filtering={"campaign_ids":["{campaign-id}"]}' \
--header "Access-Token: $TIKTOK_ADS_TOKEN" | jq .
Create campaigns paused unless the user explicitly asks to launch live traffic. Check the advertiser currency and current TikTok Ads docs before setting budgets.
cat > /tmp/tiktok-campaign.json << 'EOF'
{
"advertiser_id": "{advertiser-id}",
"campaign_name": "My TikTok Campaign",
"objective_type": "REACH",
"budget_mode": "BUDGET_MODE_DAY",
"budget": 50,
"operation_status": "DISABLE"
}
EOF
curl -sS -X POST "https://business-api.tiktok.com/open_api/v1.3/campaign/create/" \
--header "Access-Token: $TIKTOK_ADS_TOKEN" \
--header "Content-Type: application/json" \
-d @/tmp/tiktok-campaign.json | jq .
cat > /tmp/tiktok-campaign-update.json << 'EOF'
{
"advertiser_id": "{advertiser-id}",
"campaign_id": "{campaign-id}",
"operation_status": "DISABLE"
}
EOF
curl -sS -X POST "https://business-api.tiktok.com/open_api/v1.3/campaign/update/" \
--header "Access-Token: $TIKTOK_ADS_TOKEN" \
--header "Content-Type: application/json" \
-d @/tmp/tiktok-campaign-update.json | jq .
curl -sS --get "https://business-api.tiktok.com/open_api/v1.3/adgroup/get/" \
--data-urlencode "advertiser_id={advertiser-id}" \
--data-urlencode "page_size=20" \
--header "Access-Token: $TIKTOK_ADS_TOKEN" | jq .
curl -sS --get "https://business-api.tiktok.com/open_api/v1.3/adgroup/get/" \
--data-urlencode "advertiser_id={advertiser-id}" \
--data-urlencode 'filtering={"adgroup_ids":["{adgroup-id}"]}' \
--header "Access-Token: $TIKTOK_ADS_TOKEN" | jq .
curl -sS --get "https://business-api.tiktok.com/open_api/v1.3/ad/get/" \
--data-urlencode "advertiser_id={advertiser-id}" \
--data-urlencode "page_size=20" \
--header "Access-Token: $TIKTOK_ADS_TOKEN" | jq .
curl -sS --get "https://business-api.tiktok.com/open_api/v1.3/ad/get/" \
--data-urlencode "advertiser_id={advertiser-id}" \
--data-urlencode 'filtering={"ad_ids":["{ad-id}"]}' \
--header "Access-Token: $TIKTOK_ADS_TOKEN" | jq .
cat > /tmp/tiktok-report.json << 'EOF'
{
"advertiser_id": "{advertiser-id}",
"report_type": "BASIC",
"data_level": "AUCTION_CAMPAIGN",
"dimensions": ["campaign_id"],
"metrics": ["spend", "impressions", "clicks", "ctr", "cpc", "cpm", "conversion"],
"start_date": "2026-06-01",
"end_date": "2026-06-10",
"page_size": 100
}
EOF
curl -sS -X POST "https://business-api.tiktok.com/open_api/v1.3/report/integrated/get/" \
--header "Access-Token: $TIKTOK_ADS_TOKEN" \
--header "Content-Type: application/json" \
-d @/tmp/tiktok-report.json | jq .
cat > /tmp/tiktok-daily-report.json << 'EOF'
{
"advertiser_id": "{advertiser-id}",
"report_type": "BASIC",
"data_level": "AUCTION_CAMPAIGN",
"dimensions": ["campaign_id", "stat_time_day"],
"metrics": ["spend", "impressions", "clicks", "ctr", "cpc", "cpm", "conversion"],
"start_date": "2026-06-01",
"end_date": "2026-06-10",
"page_size": 100
}
EOF
curl -sS -X POST "https://business-api.tiktok.com/open_api/v1.3/report/integrated/get/" \
--header "Access-Token: $TIKTOK_ADS_TOKEN" \
--header "Content-Type: application/json" \
-d @/tmp/tiktok-daily-report.json | jq .
For list and report endpoints, pass page and page_size, then continue while the response indicates more data. Preserve the original filters exactly across pages.
Google Maps Platform API for geocoding, places, routes, and distance matrices. Use when user mentions "Google Maps", "geocode", "directions", "places API", route matrix, or asks to look up an address, route, or place metadata.
A high-fashion editorial video style - cold desaturated grade, dramatic high-contrast light, monumental clean architecture or backdrop, deliberate model pose, strong silhouette, and luxury material texture. Applies to fashion, beauty, luxury, and personal-brand subjects. Trigger on /fashion-editorial, "Fashion Editorial", "luxury fashion campaign", "high fashion video", or "editorial model film".
A hand-drawn fantasy animation video style - painterly 2D backgrounds, expressive simple characters, lush nature, soft diffused light, warm storybook color, and gentle magical wonder. Applies to any fantasy, character, nature, or adventure subject. Trigger on /hand-drawn-fantasy-anime, "hand-drawn fantasy animation", "painterly 2D fantasy", "storybook anime", or "warm forest animation".
A dark luxury product macro video style - premium materials in extreme close-up, black studio, pinpoint specular highlights, ultra-shallow focus, engraved or mechanical detail, and refined reveal pacing. Applies to watches, jewelry, pens, cameras, fragrance caps, and other high-end objects. Trigger on /luxury-product, "Luxury Product", "premium product macro", "dark luxury product video", or "metal detail reveal".
A sports performance advertising video style - athlete effort, gear and body close-ups, impact rhythm, motion blur, Dutch or low angles, high-contrast desaturated grade, and dramatic rim light. Applies to any sport, athlete, training action, or performance product. Trigger on /sports-performance-ad, "sports performance ad", "athletic commercial", "training commercial", or "sports brand film".
Playful-editorial presentation look — saturated colour fields, scalloped sunburst badges and pill chips, oversized stacked headlines. Carnival palette · Archivo + Manrope · pill radius. The design system (visual language).