Advertising

TikTok Marketing Data Extractor

Vern's TikTok Marketing extractor imports a new user's advertising data — campaigns, ad group audience reports by country daily, ad group audience reports by platform daily, and ad group audience reports daily — into your product through a single managed migration, handling TikTok Marketing's auth, pagination, and rate limits for you. It's built for teams onboarding customers off TikTok Marketing who want their data in your app from day one.

Start migration

Browse all extractors

TikTok Marketing

SaaS API (REST)

Managed auth, retries, and throttling

Normalized JSON, CSV, and DB-ready output

Cleaned JSON, CSV, and DB-ready output

Export coverage

Know exactly what Vern pulls before you migrate.

Objects Vern extracts

Vern extracts the full set of queryable TikTok Marketing objects (28 total), including: Ad Group Audience Reports By Country Daily, Ad Group Audience Reports By Platform Daily, Ad Group Audience Reports Daily, Ad Groups, Ad Groups Reports Daily, Ad Groups Reports Hourly, Ad Groups Reports Lifetime, Ads, Ads Audience Reports By Country Daily, Ads Audience Reports By Platform Daily, Ads Audience Reports By Province Daily, Ads Audience Reports Daily, Ads Reports Daily, Ads Reports Hourly, Ads Reports Lifetime, Advertisers, Audiences, Campaigns, Campaigns Audience Reports By Country Daily, Campaigns Audience Reports By Platform Daily, Campaigns Audience Reports Daily, Campaigns Reports Daily, Campaigns Reports Hourly, Campaigns Reports Lifetime, Creative Assets Images, Creative Assets Music, Creative Assets Portfolios, and Creative Assets Videos. 3 of these support incremental change tracking, so syncs pull only what changed.

Output schema

Normalized JSON per object with referential keys preserved, so the relationships between your user's records survive the import. Timestamps are returned in ISO 8601. Delivered as JSON or CSV, or loaded straight into your own application database or pushed to your API — whatever your product expects.

Where it can land

Your own application database (Postgres, MySQL), a direct push to your API or webhook, or JSON/CSV files, plus another advertising system (Amazon Ads, Apple Ads, AWIN Advertiser) when a user is switching tools.

Source details

Built for the source type shown above, with extractor content refreshed from the collection record.

Managed by Vern

The details you normally have to build yourself.

Authentication

OAuth 2.0 (Authorization Code flow). Your new user authorizes TikTok Marketing once during onboarding — their credentials never touch your code. TikTok Marketing access tokens are short-lived and refresh tokens roll on the provider's own schedule, so Vern manages the full token lifecycle and refresh and the import never drops midway.

Pagination

Vern detects and handles TikTok Marketing's paging model (cursor, page-number, or offset) internally and returns one consistent, de-duplicated result set — so you import a user's complete data without ever managing page tokens.

Rate limits and gotchas

TikTok Marketing enforces its own API rate limits. Vern queues and throttles requests internally so importing a new user's data never trips a 429 — even on a large account.

OAuth-based sources expire access tokens frequently and require a working refresh flow — a dropped refresh is the most common cause of a half-finished import. Vern owns the refresh loop so a new user's onboarding completes even on a long extraction.

API quickstart

1. Create a migration for TikTok Marketing
curl -X POST https://app.vern.so/api/v1/migrations \
  -H "x-api-key: $VERN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "TikTok Marketing → Postgres", "source": "TikTok Marketing" }'
→ { "migration_id": "mig_..." }
2. Generate the extraction recipe (pulls live via the TikTok Marketing API)
curl -X POST https://app.vern.so/api/v1/migrations/$MIGRATION_ID/runs \
  -H "x-api-key: $VERN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "kind": "generate", "extract_via_api": true }'
3. Run the approved extraction
curl -X POST https://app.vern.so/api/v1/migrations/$MIGRATION_ID/runs \
  -H "x-api-key: $VERN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "kind": "execute" }'
4. Download the normalized CSV export
curl https://app.vern.so/api/v1/migrations/$MIGRATION_ID/exports/{template} \
  -H "x-api-key: $VERN_API_KEY" -o tiktok-marketing_export.csv

A cleaner way to extract without rebuilding source-specific plumbing.

View docs

Common questions

Can I keep a user's TikTok Marketing data in sync after the first import? Yes — 3 TikTok Marketing objects support incremental change tracking, so after the first full import Vern pulls only what changed on re-run.

Can I move a user from TikTok Marketing to Amazon Ads? Yes — Vern normalizes the TikTok Marketing data model into typed tables that map cleanly onto Amazon Ads and into your own product.

What does it cost to read the TikTok Marketing API? TikTok Marketing's own API access follows TikTok Marketing's pricing/plan; Vern is billed separately per import. Check TikTok Marketing's developer docs for their current limits.