Reference
TikTok Ads tools
Manage TikTok advertising campaigns and access performance analytics.
On this page
Before you begin
Connect the relevant TikTok Ads account through Accounts, then connect your AI assistant. Confirm the target account and date range before querying data or making changes.
This is the generated catalog. The tools shown in your AI assistant depend on your connected accounts, active workspace, role, write permissions, enabled features and the client's supported tool surface. A listed tool is not a promise that it is enabled in every workspace. See accounts, workspace access and troubleshooting.
Available tools
9 tools · API v1.3.
| Tool | Access | Purpose |
|---|---|---|
tiktok_get_advertiser_info | Read | Get advertiser account information |
tiktok_query | Read | Query campaigns, adgroups, or ads with flexible filtering |
tiktok_get_report | Read | Get performance reports at campaign, adgroup, or ad level |
tiktok_get_audiences | Read | List custom and/or lookalike audiences |
tiktok_get_asset_info | Read | Get video or image asset info with optional embedded images |
tiktok_get_ads_with_creatives | Read | Get ads with creative assets and performance data |
tiktok_list_advertisers | Read | List ALL TikTok advertiser accounts you've connected. |
tiktok_manage | Write | Create, update or pause TikTok campaigns, ad groups and ads. |
tiktok_upload | Write | Upload an image or video to a TikTok advertiser's ad asset library. |
Write tools can change account settings, campaigns or workspace content. Confirm the target and proposed changes before running them.
Private local uploads support Meta, TikTok, LinkedIn and Google Ads. Your workspace needs upload access to the destination, and your AI client needs file access and HTTP upload. JPEG/PNG images up to 20 MB (20,000,000 bytes) and MP4 videos up to 500 MB (500,000,000 bytes) are supported by the upload flow; destination-specific restrictions still apply. Existing account-library IDs remain available. Read the upload guide before uploading.
Example questions
Show my TikTok ad accounts
What's my TikTok campaign performance?
Which TikTok ads have best engagement?
Compare my ad groups by cost per click
What's my TikTok ad reach this week?
API capabilities
Available fields and combinations depend on the resource, account and campaign type. Adapt the examples to your selected account.
Metrics
| Category | Fields |
|---|---|
| Traffic | impressions, clicks, ctr, spend, cpc, cpm |
| Reach & Frequency | reach, frequency, cost_per_1000_reached |
| Conversion | conversion, cost_per_conversion, conversion_rate, total_purchase_value, total_purchase, purchase_value_per_conversion |
| Video Engagement | video_views, video_watched_2s, video_watched_6s, video_play_actions, average_video_play, video_views_p25, video_views_p50, video_views_p75, video_views_p100 |
| Social Engagement | likes, comments, shares, follows, profile_visits, profile_visits_rate |
| App | app_install, app_install_cost, app_event_add_to_cart, app_event_purchase |
Dimensions
| Category | Fields |
|---|---|
| Data Level | AUCTION_CAMPAIGN, AUCTION_ADGROUP, AUCTION_AD |
| Time | stat_time_day, stat_time_hour |
| Geographic | country_code, province_id |
| Platform & Device | platform (iOS, Android, PC), device_model_id, carrier_id |
Query examples
Campaign Performance Analysis
Get daily campaign metrics with conversions
Tool: tiktok_get_report.
tiktok_get_report(
advertiser_id="7123456789",
level="campaign",
start_date="2025-01-01",
end_date="2025-01-31",
metrics=["impressions", "clicks", "ctr", "spend",
"conversion", "cost_per_conversion"]
)
Query Campaigns
List all campaigns with optional filtering
Tool: tiktok_query.
tiktok_query(
advertiser_id="7123456789",
entity_type="campaigns",
status="ENABLE"
)
Audience Discovery
List custom and lookalike audiences
Tool: tiktok_get_audiences.
tiktok_get_audiences(
advertiser_id="7123456789",
audience_type="custom" # or "lookalike" or omit for both
)
Technical reference
API endpoint: business-api.tiktok.com/open_api/v1.3. Status: stable.
Rate limits
| Limit | Scope | Notes |
|---|---|---|
| 600 requests/minute | Sliding window per endpoint | Headers: X-RateLimit-Remaining, X-RateLimit-Reset |
OAuth scopes
| Scope | Description | Required |
|---|---|---|
advertiser_management | Manage ad accounts | Yes |
campaign_read | Read campaigns, ad groups, ads | Yes |
report_read | Access reporting data | Yes |
audience_management | Manage custom audiences | No |
Limitations and notes
- Rate limit: 600 requests/minute (sliding window)
- Report data has 1-2 hour delay for current metrics
- Pixel event data requires specific date format (YYYY-MM-DD)
- Reach and frequency are estimates, not exact numbers
- All requests require valid advertiser_id parameter
- Some geographic breakdowns only available in specific regions
