Connect your data to Claude in 1 minute. No code needed Try it now
Sign In Get a demo Start for free
TikTok Ads PostgreSQL

Connect TikTok Ads to PostgreSQL

Send TikTok Ads basic campaign report, basic ad group report, basic ad report (upgraded smart+ by ad) and 15 more report types to PostgreSQL on a schedule. Pick the ad accounts, choose metrics and dimensions, filter by date and add your own filters. Refresh as often as every 15 minutes.

Get started for free Get a demo
capterra
star star star star star

4.9/5

PostgreSQL schema tiktok_ads
  • basic_campaign_report
  • basic_ad_group_report
  • basic_ad_report_upgraded_smart_by_ad
  • basic_ad_report_upgraded_smart_by_creative
  • gmv_max_campaign_report
  • 13 more report types
Each TikTok Ads report type lands in its own table. You pick the schema and table names.
Trusted by 200K+ users worldwide
Tradezella
Stanford
Webtoon
Getir
Stellar
Anker
ParentSquare
Bac 50
Benzinga
Matterport

How to connect TikTok Ads and PostgreSQL

7 steps. You can preview the TikTok Ads data in Coupler.io before anything reaches PostgreSQL.

Step 1 of 7

Connect TikTok Ads

Sign in to TikTok Ads and authorize Coupler.io. There's no API key to copy.

Sign in with TikTok Ads

Step 2 of 7

Choose what to export

Pick the TikTok Ads data you want in PostgreSQL.

Frequently used

Core components

Reports

Show 10 more report types Show fewer report types

Reports

Ad accountsNot setSpecify advertisers with the data to be extracted. If you don’t see your advertiser accounts in the list, try to reconnect your account in the ‘Connections’ section.
StoresNot setSpecify stores with the data to be extracted.

Step 3 of 7

Set the report period

Choose the date range the report covers.

Start dateAny dateSpecify the start date of the period for which to export data.
End dateAny dateSpecify the end date of the period for which to export data.
Split data by periodNot setSelect a value for “split data by period”, e.g. “Daily”, “Hourly”, “Totals only”.

Step 4 of 7

Pick metrics and dimensions

Choose what to measure and how to break it down.

Targeting dimensionNot setSelect a value for “targeting dimension”, e.g. “Country code”, “Ad type”.
Asset dimensionNot setSelect a value for “asset dimension”, e.g. “Component name”, “Customer event type”, “Event source id”.
Search dimensionNot setSelect a value for “search dimension”, e.g. “Search terms”.
Audience dimensionsNot setSelect one or more values for “audience dimensions”, e.g. “Gender”, “Age”, “Country code”, “Province”, “DMA region”.
Show 2 more fields Show fewer fields
DSA dimensionsNot setSelect one or more values for “dsa dimensions”, e.g. “Catalog id”, “Product set id”, “Product id”, “Sku id”.
MetricsNot setSelect one or more values for “metrics”, e.g. “Account name”, “Advertiser account id”, “Advertising objective”, “App promotion type”, “Campaign automation type”.

Step 5 of 7

Fine-tune the export

Optional settings for this TikTok Ads export.

Advanced filtersNot set

Step 6 of 7

Connect PostgreSQL

Enter your PostgreSQL connection details, then the schema and table for the TikTok Ads data.

Hostdb.example.comHostname, IPv4, or IPv6 address of the server
Port5432Default is 5432
DatabaseanalyticsThe target database name
Tablebasic_campaign_reportCreated automatically on the first run
Show 3 more fields Show fewer fields
UsercouplerUser with CREATE and INSERT privileges
Password••••••••••••The database user's password
Schematiktok_adsCreated automatically if it doesn't exist

Step 7 of 7

Choose a write mode and schedule

Every run either replaces or appends the data in PostgreSQL. Run it as often as every 15 minutes.

Write mode

Each run deletes the existing rows in basic_campaign_report and loads fresh TikTok Ads data.

Build this flow for free

Build your TikTok Ads integrations with these destinations

Data Studio icon
Data Studio
Dashboards
Google Sheets icon
Google Sheets
Spreadsheets
Claude icon
Claude
AI integrations
ChatGPT icon
ChatGPT
AI integrations
BigQuery icon
BigQuery
Data warehouses
Power BI icon
Power BI
Dashboards
Microsoft Excel icon
Microsoft Excel
Spreadsheets
Snowflake icon
Snowflake
Data warehouses
Redshift icon
Redshift
Data warehouses
JSON icon
JSON
API
Tableau icon
Tableau
Dashboards
Qlik icon
Qlik
Dashboards
CSV icon
CSV
Spreadsheets
OpenClaw icon
OpenClaw
AI integrations
Cursor icon
Cursor
AI integrations
Perplexity icon
Perplexity
AI integrations
Gemini icon
Gemini
AI integrations
Supabase icon
Supabase
Data warehouses
Copilot icon
Copilot
AI integrations
Custom MCP icon
Custom MCP
AI integrations

Get the most of TikTok Ads to PostgreSQL integration

Gather data icon

Gather data

Export data from numerous apps and sources into a single destination. Blend data from different apps to get a single source of truth.
Understand data icon

Understand data

Preview, transform, sort, and filter data for better clarity in just a few clicks in the Coupler.io interface. Take your data analytics to the next level.
Automate data icon

Automate data

Access data that is always up to date by enabling the automatic data refresh on a schedule as often as every 15 minutes and using triggered automation.
Act on data icon

Act on data

Visualize your data by quickly connecting to data visualization and BI tools. Build insightful dashboards in a breeze and make better decisions.
TikTok Ads to PostgreSQL questions

18 report types, including Basic campaign report, Basic ad group report, Basic ad report (Upgraded Smart+ by ad), Basic ad report (Upgraded Smart+ by creative) and GMV Max campaign report.

You sign in to TikTok Ads and authorize Coupler.io. There's no API key to copy.

Yes. Set the start date and end date to cover the period you need. Splitting the data by period is available too.

Yes. Pick from 1,068 metrics and 34 dimensions.

Yes. Add filter conditions in the source settings to keep only the TikTok Ads records you need.

Yes, if the database user has CREATE privileges. Coupler.io creates the tiktok_ads schema and the basic_campaign_report table on the first run.

Yes. Append adds new rows to basic_campaign_report on each run, while Replace swaps in a fresh copy. With Append, add new TikTok Ads columns to the table yourself before the next run.

On a schedule you choose, from monthly down to every 15 minutes, depending on your Coupler.io plan.

Yes. Add more sources to the same data flow, for example Google Ads or Facebook Ads, and join or append them before the data reaches PostgreSQL.

High five for scrolling till the very end!
See you in the app!

GET STARTED FOR FREE Get a demo