List
Read live records straight from the TikTok Marketing API.
- Source
- Marketing Analytics
- Generally available
- 15 entities
Move TikTok Marketing data anywhere it matters.
Pull TikTok Marketing advertisers, adgroups and ads into any warehouse or AI app.
Source
TikTok Marketing
Snowflake
BigQuery
Postgres
Databricks
Claude
- Streams
- 44
- Incremental streams
- 30
- Entities
- 15
- Actions
- 3
- Destinations
- 50+
- Certified support
- 5.3.4
Overview
What is the Airbyte TikTok Marketing connector?
The Airbyte TikTok Marketing connector extracts data from TikTok Marketing and loads it into 50+ destinations such as Snowflake, BigQuery, Databricks or Postgres, with full refresh and incremental sync. It publishes 44 streams you can select per connection.
- 01
Sync to your warehouse
Land 44 TikTok Marketing tables in 50+ destinations on a schedule you control.
- 02
Context store search
Query synced TikTok Marketing data with filters, sorting and semantic search, without spending TikTok Marketing API rate limits.
- 03
Incremental syncs
Pull only the records that changed since the last run instead of reloading everything.
- 04
One authorization
Authenticate TikTok Marketing once. The same connection powers scheduled syncs and runtime actions.
44 streams
Every table you can sync from TikTok Marketing
Advertisers Sync modes FullIncr. AdGroupsIncremental Sync modes FullIncr. AdsIncremental Sync modes FullIncr. CampaignsIncremental Sync modes FullIncr. AdsReportsHourlyIncremental Sync modes FullIncr. AdsReportsDailyIncremental Sync modes FullIncr.
Setup
Live in ten steps
Open the TikTok for Business Marketing source connector in Airbyte.
Click on the "Create new connection" button.
Enter a name for your connection.
Enter your TikTok for Business Marketing account credentials, including your username and password.
Click on the "Test connection" button to ensure that your credentials are correct and that the connection is successful.
Once the connection is successful, select the data you want to sync from TikTok for Business Marketing.
Choose the destination where you want to send the data.
Map the fields from TikTok for Business Marketing to the corresponding fields in the destination.
Set up any additional configurations or filters as needed.
Click on the "Create connection" button to start syncing your data. Note: It is important to ensure that your TikTok for Business Marketing account has the necessary permissions to access the data you want to sync. Additionally, make sure to follow any best practices or guidelines provided by TikTok for Business Marketing to ensure that your data is being used appropriately.
Configuration fields
| Field | Type | Description |
|---|---|---|
| attribution_window | integer | The attribution window in days. |
| credentials | object | Authentication method |
| end_date | string | The date until which you'd like to replicate data for all incremental streams, in the format YYYY-MM-DD. All data generated between start_date and this date will be replicated. Not setting this option will result in always syncing the data till the current date. |
| include_deleted | boolean | Set to active if you want to include deleted data in report based streams and Ads, Ad Groups and Campaign streams. |
| report_granularity | integer | The number of days per API request for daily report streams. Use the default 30 for most accounts. If TikTok rejects a request as too large (error 40067), the connector automatically splits that date range in half and retries, down to one day, so you no longer need to lower this value for that. Smaller values make more API requests from the start, but splitting restarts for every date range, so accounts that often hit error 40067 sync faster with a smaller value (for example, 7). |
| start_date | string | The Start Date in format: YYYY-MM-DD. Any data before this date will not be replicated. If this parameter is not set, all data will be replicated. |
3 actions
Supported TikTok Marketing actions
Context Store Search
Query synced data with filters and sorting, with no API rate limits.
Semantic Search
Natural-language search across synced TikTok Marketing records.
Full parameter-level details live in the TikTok Marketing entity reference.
Hybrid deployment
Sovereign by architecture, not by policy.
The data plane runs in your environment. Records, credentials and keys stay with you; the control plane only receives configuration and job metadata.
- Cloud
- OSS
- Hybrid
Your environment
Airbyte control plane
Use cases
What teams build with TikTok Marketing
List all my TikTok advertisers
Show me all campaigns for my advertiser account
List all ad groups
Show me all ads
List my custom audiences
Show me all creative asset images
List creative asset videos
Show me daily ad performance reports
Get campaign performance metrics for the last 30 days
Show me advertiser spend reports
Show me hourly ad performance reports
Get lifetime ad performance metrics
List all Spark Ad posts
Show me my product catalogs
Which campaigns have the highest budget?
Find all paused ad groups
What ads were created last month?
Show campaigns with lifetime budget mode
Which ads had the most impressions yesterday?
What is my total ad spend this month?
Which campaigns have the highest click-through rate?
Which Spark Ads are currently authorized?
Find catalogs with the most products
Related connectors
FAQ
TikTok Marketing connector questions
Do I need more than one TikTok Marketing connection?
No. One TikTok Marketing authorization powers both the scheduled syncs that land data in your destination and the entity actions your agents call at runtime.
Do TikTok Marketing entity actions need a sync to run first?
No. Entity actions read and write through the TikTok Marketing API as they are called, so they work immediately. Context store search is the exception: it queries data Airbyte has already synced, which is what lets it filter and sort without spending API rate limits.
What data can I sync from TikTok Marketing with Airbyte?
44 streams, including Advertisers, AdGroups, Ads, Campaigns, AdsReportsHourly, AdsReportsDaily, AdsReportsLifetime, AdvertisersReportsHourly and more.
Does the TikTok Marketing connector support incremental sync?
Yes. AdGroups, Ads, Campaigns, AdsReportsHourly and others support incremental sync, and every documented stream supports full refresh.
Where can I run the TikTok Marketing connector?
Run the TikTok Marketing connector on Cloud, OSS, Hybrid. Hybrid deployments keep the data plane in your environment while the control plane orchestrates syncs.
Didn't find your answer? Talk to sales
Start syncing TikTok Marketing in minutes.
Free 14-day trial. One connection powers your scheduled syncs and your live TikTok Marketing actions.