Tiktok Ads
API Documentation: TikTok Marketing API Documentation
High-Level Information:
The TikTok Ads API allows you to access various data related to your advertising campaigns on TikTok. The integration focuses on pulling data for the following types of reports:
- Campaign Performance Reports: These reports provide detailed information on the performance of your ad campaigns on TikTok, including metrics such as impressions, clicks, conversions, and ad spend. This data helps you assess how well your campaigns are performing and identify areas for optimization.
- Ad Group and Creative Performance Reports: These reports give insights into the performance of individual ad groups and creatives, including metrics like click-through rates (CTR), cost-per-click (CPC), and conversion rates. Understanding this data helps refine creative strategies and ad group targeting for better results.
Source Setup Guide
Click 
in the Edit Source form to the left.
Step 2
Follow the authentication flow (OAuth) on TikTok’s website to grant Singular the required permissions.
The user performing the OAuth authentication must be added to the TikTok advertiser account(s) you want to sync.
To add a user, go to TikTok Business Center → Accounts → View → Manage Permissions.
Ensure the user has the necessary permissions to access data from the accounts you intend to sync.
Step 3 (Optional)
If your authenticated user has access to multiple advertiser accounts, select the Advertiser account(s) you want Singular to sync.
Only advertiser accounts that the authenticated user is authorized to access will be available for selection.
Step 4 (Optional)
You can generate custom reports from the TikTok Ads API to meet your specific requirements. We support both basic and audience reports for TikTok's auction ads. Here's how you can create a custom report:
- Name Your Custom Report: Give your report a unique name.
- Select Your Desired Report Level: Choose a combination of Report Type (Basic vs. Audience) and Data Level (Ad, Ad Group, Campaign). Learn more about Tiktok Reports.
- Select Dimensions: Choose the dimensions you want to include in your report.
- Choose Aggregation Period: Specify the time period for data aggregation.
- Add Metrics: Include attribute metrics, basic metrics, and page event metrics.
- Save the Report: Click "Save". Your custom report will now be available as a stream in all your TikTok connections.
Important to note!
TikTok imposes limitations on dimension grouping and metric availability for each dimension. We recommend consulting TikTok's documentation for Basic Reports and Audience Reports before saving your report. Attempting to save an invalid report will result in failure.
Step 5
Confirm you can see your email and profile picture, and that the source is Connected.
Connection Setup Guide
After you connect TikTok Ads to a destination, configure the connection settings:
- Advertiser IDs (Ad accounts): Select which TikTok advertiser accounts to sync. The list is populated from the ad accounts your authenticated TikTok user is authorized to access. If the user has no authorized ad accounts, no data will be extracted.
- Connection Pull Schedule: How frequently data is extracted from the source.
- Backfill (Days): How many days of historical data to retrieve on each run.
- Destination-specific settings: Settings such as Dataset Name or Target Schema (depends on your destination).
- Schema Migration Policy: How Singular handles schema changes from the source.
Schema ERD
Explore the interactive entity relationship diagram for Tiktok Ads.
Data Streams
ad_daily_age_gender
ad_daily_country
ad_daily_dma
ad_daily_language
ad_daily_placement
ad_daily_platform
ad_group
ad
adgroup_daily_age_gender
adgroup_daily_country
adgroup_daily_dma
adgroup_daily_language
adgroup_daily_placement
adgroup_daily_platform
advertisers
auction_ad_basic_daily
auction_adgroup_basic_daily
auction_campaign_basic_daily
auction_skan_ad_basic_daily
business_center_invoices
campaign_daily_age_gender
campaign_daily_country
campaign_daily_dma
campaign_daily_language
campaign_daily_placement
campaign_daily_platform
campaign
creative_basic_images_daily
creative_basic_images_lifetime
creative_basic_videos_daily
creative_basic_videos_lifetime
custom_audience
image
pixel_event_rule
pixel_event
pixel_statistics
pixel
video_insights_daily
video
Notes
- TikTok report API rate limits: TikTok applies report request limits at the app level (not per advertiser or per stream). If you sync multiple report-based streams and/or multiple advertisers concurrently, you may see intermittent rate-limit responses from TikTok. The connector automatically throttles report requests and retries with exponential backoff and jitter when TikTok returns a QPS limit error.
Troubleshooting
If your sync fails with TikTok reporting rate-limit errors (for example, messages indicating a QPS/“too many requests” limit), retry the run after a short delay.
TikTok applies report QPS limits at the app level (not per advertiser or per stream). This means concurrent runs or multiple report-heavy streams can collectively exceed the limit even if each stream is configured reasonably. If you see intermittent rate-limit failures, reduce concurrency (fewer simultaneous runs) and re-run the sync.