A managed connector is the fastest way to send TikTok Ads data to JSON. A typical setup has eight steps: connect the account, select the advertiser, choose a report, select metrics and dimensions, set the reporting period, add filters, create the endpoint and schedule refreshes.
Build directly with the TikTok Marketing API when you need control over authentication, data processing, schema design or campaign management.
| Requirement | Recommended approach |
|---|---|
| Scheduled TikTok Ads reports in JSON | Managed connector |
| No-code or low-code setup | Managed connector |
| Custom campaign management | TikTok Marketing API |
| Custom data warehouse pipeline | TikTok Marketing API or managed connector |
| A URL that scripts can request | JSON connector with a stable endpoint |
| Full control over API responses | TikTok Marketing API |
TikTok Ads to JSON means extracting advertising data from TikTok Ads Manager and delivering it as structured JSON.
The data can include:
JSON is useful because scripts, dashboards, applications, AI tools and data pipelines can read it without manually downloading spreadsheets.
TikTok's Marketing API provides programmatic access to TikTok Ads Manager for querying data, creating campaigns, managing ads and generating reports.
A managed TikTok Ads to JSON integration usually works like this:
For example, Coupler.io lets users connect TikTok Ads, choose a report, select metrics and dimensions, apply filters and generate an HTTPS URL that returns the latest data as JSON.
A script can request the endpoint with a standard HTTP GET request:
curl "$TIKTOK_JSON_URL"
The response can then be sent to a data warehouse, internal application, reporting tool or automation workflow.
A campaign performance report could use a structure like this:
{
"source": "tiktok_ads",
"report": "campaign_performance",
"currency": "USD",
"rows": [
{
"campaign_id": "1234567890",
"campaign_name": "Spring Product Campaign",
"ad_group_id": "9876543210",
"impressions": 125000,
"clicks": 4200,
"spend": 1850.75,
"conversions": 142,
"ctr": 0.0336,
"cpc": 0.4407
}
]
}
This example is illustrative. Field names and available values depend on the report type, selected dimensions, selected metrics and connector schema.
Choose the report according to the level of analysis you need.
| Report type | Best for |
|---|---|
| Campaign report | Budget, delivery and performance by campaign |
| Ad group report | Audience, placement, bidding and optimization analysis |
| Ad report | Creative-level performance |
| Creative report | Comparing videos, images and ad variations |
| Advertiser report | Account-level summaries |
| Audience report | Demographic and audience breakdowns |
| Product or catalog report | Commerce and product performance |
A campaign report is usually a practical starting point because it gives you a compact view of spend and results. Use an ad-level report when you need to compare creative performance or identify which videos generate the strongest results.
Use a managed connector for reporting with less development work. Use the TikTok Marketing API when you need to control the requests, data processing or advertising operations.
A managed connector is a good fit when the main goal is reporting.
Advantages include:
Coupler.io states that its TikTok Ads integration supports campaign, ad group, ad and other report types, historical reporting periods, filters, scheduled refreshes and JSON delivery through an HTTPS URL.
The trade-offs are:
The TikTok Marketing API is a better fit for developers building a custom data pipeline or advertising application.
Advantages include:
TikTok describes the Marketing API as the API for working with TikTok Ads Manager at scale. It supports data queries, ad creation, campaign management and customized reports.
The trade-offs are:
A custom TikTok Ads to JSON pipeline usually has five components:
AuthenticationThe application obtains the required TikTok API credentials and access token.
Report requestThe application requests a campaign, ad group, ad or other report.
PaginationThe application retrieves every result page when a report contains more records than one response can return.
TransformationThe application renames fields, converts data types and standardizes dates, currencies and metric values.
JSON deliveryThe application stores the data as a file, serves it from an API endpoint or loads it into another system.
A simplified application response could look like this:
{
"source": "tiktok_ads",
"data": [
{
"campaign_id": "1234567890",
"spend": 1850.75,
"clicks": 4200
}
]
}
A production implementation should also handle expired tokens, rate limits, failed requests, missing metrics, duplicate rows and changes to report fields.
A JSON endpoint may contain an access token in the URL. Anyone with the complete URL may be able to request the data.
Treat a tokenized JSON URL like a password:
Coupler.io warns that users with the complete JSON URL can access the data because the URL contains an access token.
The TikTok Marketing API and TikTok Events API serve different purposes.
TikTok describes the Events API as a way to share marketing data from web, app and offline sources. The Marketing API handles advertising operations and reporting.
Use TikTok Ads to JSON when you need reporting or advertising data outside TikTok Ads Manager. Use the Events API when you need to send conversion events into TikTok.
Use a managed TikTok Ads to JSON connector when you need scheduled reporting, a reusable endpoint or a quick connection to a script, dashboard or AI tool.
Use the TikTok Marketing API when you are building a custom advertising platform, need advanced data transformation or want to manage campaigns programmatically.
For a simple reporting pipeline:
This approach provides TikTok Ads data in JSON without requiring a complete custom API integration.