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.