TikTok’s official Marketing API for managing the full lifecycle of TikTok ad campaigns on behalf of authorized advertisers — advertiser discovery, campaigns, ad groups, ads, audiences, custom audiences, creatives, pixels, conversion events, and reporting.
Use this file to discover all available pages before exploring further.
TikTok’s official Marketing API for managing the full lifecycle of TikTok ad campaigns on behalf of authorized advertisers — advertiser discovery, campaigns, ad groups, ads, audiences, custom audiences, creatives, pixels, conversion events, and reporting. Best for agents that need to launch, optimize, or report on TikTok ads through TikTok For Business accounts. Unlike aggregator marketing platforms, this is a first-party surface that exposes TikTok-specific targeting (interests, behaviors, hashtags) and granular reporting breakdowns (placement, creative, audience).14 example endpoints available through Lava’s AI Gateway. See the TikTok Ads API docs for full documentation.
This provider requires your own credentials — connect your API key or OAuth account before use.
This is a catch-all provider — any valid URL under https://business-api.tiktok.com is supported. TikTok Marketing API. Base URL: https://business-api.tiktok.com/open_api/v1.3. Auth header is Access-Token: <token> (NOT Authorization: Bearer). Discover advertiser_ids via GET /oauth2/advertiser/get/. Most resources are scoped to an advertiser_id query param, e.g. /campaign/get/?advertiser_id=…&campaign_ids=[…]. Responses are wrapped in an envelope: { code, message, request_id, data } — non-zero code indicates an error. Pagination uses page/page_size query params and returns data.page_info { page, page_size, total_number, total_page }. Reports endpoint (GET /report/integrated/get/) accepts breakdowns, dimensions, metrics, and date ranges as query params. See https://business-api.tiktok.com/portal/docs for full reference. The endpoints below are curated examples.
List advertisers that have granted this app permission to manage their accounts. Start here after OAuth to discover the advertiser_ids the user authorized; every other endpoint takes one of these as a query param. Requires app_id and secret as query params alongside the user’s Access-Token.
Fetch details for one or more advertisers — currency, time zone, status, balance, contact info. Useful for confirming an authorized advertiser_id is active before further calls.
List campaigns under an advertiser. Paginated via page/page_size; response envelope includes data.page_info . Filterable by status, objective_type, budget_mode.
Create a new campaign under an advertiser. Required: advertiser_id, campaign_name, objective_type (TRAFFIC, CONVERSIONS, REACH, VIDEO_VIEWS, LEAD_GENERATION, etc.), budget_mode, budget. New campaigns default to DISABLE; activate via campaign/update/.
List ad groups under an advertiser (optionally filtered by campaign_ids). Ad groups carry targeting, placement, bidding, schedule, and conversion event settings.
Create an ad group under a campaign. Key fields: campaign_id, adgroup_name, placement_type, placements, billing_event (CPC, CPM, OCPM), bid_type, bid_price, schedule_type, schedule_start_time, location_ids, audience_ids, interests, pixel_id (for conversion ad groups).
List ads under an advertiser (filterable by campaign_ids or adgroup_ids). Each ad references a creative (video_id or image_ids) and an ad group, inheriting targeting from the ad group.
Create one or more ads under an ad group. Each ad in creatives[] needs ad_name, ad_format, video_id (or image_ids), ad_text, call_to_action, and landing_page_url.
List custom audiences (CUSTOMER_FILE, ENGAGEMENT, WEB, APP, LOOKALIKE, etc.) under an advertiser. Use these as targeting building blocks for ad groups.
Create a customer-file custom audience. Identifiers must be SHA-256 hashed before upload (TikTok will not hash for you). After creation, use /dmp/custom_audience/file/upload/ to add hashed identifiers in batches.
List TikTok Pixels for an advertiser. Required to find a pixel_id for conversion-based ad groups and for sending server-side events via the Events API.
TikTok Events API — post a single server-side pixel event. Body fields: pixel_code, event (e.g. CompletePayment), event_id (for deduplication with browser pixel), timestamp (Unix seconds), and context.user identifiers (email, phone_number, external_id — all pre-hashed SHA-256). Optional properties for value/currency/content_id. Used for offline / CRM / CAPI conversion tracking.
