# TikTok Ads tools

Source: https://adsuperpowers.ai/docs/tools/tiktok-ads

Manage TikTok advertising campaigns and access performance analytics.

## Before you begin

Connect the relevant TikTok Ads account through [Accounts](https://adsuperpowers.ai/docs/accounts), then connect your [AI assistant](https://adsuperpowers.ai/docs/setup). 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](https://adsuperpowers.ai/docs/accounts), [workspace access](https://adsuperpowers.ai/docs/workspaces) and [troubleshooting](https://adsuperpowers.ai/docs/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](https://adsuperpowers.ai/docs/media-upload) 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?

[More example questions](https://adsuperpowers.ai/docs/examples).

## 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`.

```python
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`.

```python
tiktok_query(
    advertiser_id="7123456789",
    entity_type="campaigns",
    status="ENABLE"
)
```

#### Audience Discovery

List custom and lookalike audiences

Tool: `tiktok_get_audiences`.

```python
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

## Other platforms and tools

- [Meta Ads](https://adsuperpowers.ai/docs/tools/meta-ads)
- [Google Ads](https://adsuperpowers.ai/docs/tools/google-ads)
- [Google Analytics](https://adsuperpowers.ai/docs/tools/google-analytics)
- [Google Search Console](https://adsuperpowers.ai/docs/tools/google-search-console)
- [Google Tag Manager](https://adsuperpowers.ai/docs/tools/google-tag-manager)
- [Google Merchant Center](https://adsuperpowers.ai/docs/tools/google-merchant-center)
- [LinkedIn Ads](https://adsuperpowers.ai/docs/tools/linkedin-ads)
- [Workflows](https://adsuperpowers.ai/docs/tools/workflows)
- [Skills](https://adsuperpowers.ai/docs/tools/skills)
- [Clients](https://adsuperpowers.ai/docs/tools/clients)

[All tools](https://adsuperpowers.ai/docs/tools) · [Quickstart](https://adsuperpowers.ai/docs/quickstart)