tools/integrations/tiktok-ads.md
Advertising platform for TikTok's short-form video audience.
| Integration | Available | Notes |
|---|---|---|
| API | ✓ | Marketing API for campaigns, audiences, reporting |
| MCP | - | Not available |
| CLI | - | Not available |
| SDK | ✓ | Python SDK available |
Access-Token: {access_token}GET https://business-api.tiktok.com/open_api/v1.3/advertiser/info/?advertiser_ids=["{advertiser_id}"]
Access-Token: {access_token}
GET https://business-api.tiktok.com/open_api/v1.3/campaign/get/?advertiser_id={advertiser_id}&page=1&page_size=20
Access-Token: {access_token}
POST https://business-api.tiktok.com/open_api/v1.3/report/integrated/get/
Access-Token: {access_token}
{
"advertiser_id": "{advertiser_id}",
"report_type": "BASIC",
"dimensions": ["campaign_id"],
"metrics": ["spend", "impressions", "clicks", "conversion"],
"data_level": "AUCTION_CAMPAIGN",
"start_date": "2024-01-01",
"end_date": "2024-01-31"
}
POST https://business-api.tiktok.com/open_api/v1.3/campaign/create/
Access-Token: {access_token}
{
"advertiser_id": "{advertiser_id}",
"campaign_name": "Campaign Name",
"objective_type": "CONVERSIONS",
"budget_mode": "BUDGET_MODE_DAY",
"budget": 100
}
POST https://business-api.tiktok.com/open_api/v1.3/campaign/status/update/
Access-Token: {access_token}
{
"advertiser_id": "{advertiser_id}",
"campaign_ids": ["{campaign_id}"],
"opt_status": "ENABLE"
}
GET https://business-api.tiktok.com/open_api/v1.3/adgroup/get/?advertiser_id={advertiser_id}&campaign_ids=["{campaign_id}"]
Access-Token: {access_token}
GET https://business-api.tiktok.com/open_api/v1.3/dmp/custom_audience/list/?advertiser_id={advertiser_id}
Access-Token: {access_token}
| Metric | Description |
|---|---|
spend | Amount spent |
impressions | Ad impressions |
clicks | Clicks |
ctr | Click-through rate |
cpc | Cost per click |
cpm | Cost per 1000 impressions |
conversion | Conversions |
cost_per_conversion | CPA |
video_play_actions | Video views |
video_watched_6s | 6s views |
REACH - Brand awarenessTRAFFIC - Website trafficVIDEO_VIEWS - Video viewsLEAD_GENERATION - Lead formsCONVERSIONS - Website conversionsAPP_PROMOTION - App installs