Get business centers accessible by the current access token

Get TikTok identities (creator accounts) authorized to an advertiser. identity_type: CUSTOMIZED_USER, AUTH_CODE, TT_USER, BC_AUTH_TT. For BC_AUTH_TT, identity_authorized_bc_id is required.

Get all authorized ad accounts accessible by the current access token

Get campaigns for a specific advertiser with optional filtering

Get ad groups for a specific advertiser with optional filtering

Get ads for a specific advertiser with optional filtering

Get performance reports and analytics with comprehensive filtering and grouping options

Get GMV Max campaigns via /gmv_max/campaign/get/. Returns campaign list with status and ROI protection info. Default filter: PRODUCT_GMV_MAX.

Get GMV Max performance reports via /gmv_max/report/get/. store_ids is REQUIRED (get from campaign info endpoint). Metrics: cost, orders, cost_per_order, gross_revenue, roi, net_cost, creative_delivery_status, product_impressions, product_clicks, product_click_rate, ad_click_rate, ad_conversion_rate, ad_video_view_rate_2s/6s/p25/p50/p75/p100. Dimensions: advertiser_id, stat_time_day, item_id (item_id requires filtering with campaign_ids AND item_group_ids). Filtering: {"campaign_ids": ["..."], "item_group_ids": ["..."]}.

Get detailed info for a specific GMV Max campaign via /campaign/gmv_max/info/. Returns budget, bid, product, and scheduling details.

Get video asset details (URL, thumbnail, duration) by video IDs. Use with get_ads_tool to map ad → video_id → video URL/poster.

Get creative-level performance report (video insights, engagement, play metrics). report_type: VIDEO_INSIGHT (default).

Get videos available for GMVMAX campaigns for a given store. Returns video list with IDs for cross-referencing with creative reports.

Get Business Center balance (available funds).

Get cost summary for all ad accounts under a BC within a date range. Useful for weekly/monthly spend review.

Get BC transaction records (top-ups, deductions). transaction_level: BC or ADVERTISER. Times format: YYYY-MM-DD HH:MM:SS.

Get budget change history for a specific advertiser under BC. Track who changed budget and when.

Get stores linked to a GMVMAX advertiser account. Useful to verify store-advertiser bindings.

Get balance and basic info for individual advertiser accounts. Max 100 IDs per request.

Get GMVMAX report aligned to shop timezone. Fetches hourly data and re-aggregates to match a shop-tz day, regardless of the ad account's native timezone. Returns aggregated metrics (cost, gross_revenue, orders), ROI, and hours included.

Get Ads (manual bid) report aligned to shop timezone. Fetches hourly data and re-aggregates to match a shop-tz day. Returns cost, gmv, orders, and roas.

Get GMVMAX aggregate report for a date range (no timezone alignment). Returns cost, gmv, orders, roi.

Get Ads (manual bid) aggregate report for a date range (no timezone alignment). Returns cost, gmv, orders, roas.

Get trending hashtags on TikTok via /discovery/trending_list/. discovery_type: HASHTAG. date_range: 7DAY | 30DAY. country_code: e.g. US. Set include_history=True to get per-day rank/views breakdown.