Get business centers accessible by the current access token

Get all authorized ad accounts accessible by the current access token

Get account-level metadata (currency, timezone, industry, status) for one or more advertisers. This is foundational context for interpreting all other data — especially date breakdowns, which depend on the account timezone.

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 TikTok-specific video engagement metrics not available in the standard integrated report: 2-second views, 6-second views, completion rate, average watch time, and video play actions. At least one of campaign_ids, adgroup_ids, or ad_ids is required. data_level: AUCTION_AD | AUCTION_ADGROUP | AUCTION_CAMPAIGN. Dates are YYYY-MM-DD.

Get creative fatigue scores per ad. Indicates when an ad has been shown too frequently to the same audience and needs refreshing. Returns fatigue_status, fatigue_level, and recommendations per ad. Optionally filter by ad_ids.

Get benchmark metrics (CTR, CVR, CPM, CPC) for specific ads compared to industry averages. ad_ids is required. dimensions defaults to ['PLACEMENT']. Allowed dimension values: AD_CATEGORY, EXTERNAL_ACTION, LOCATION, PLACEMENT. objective_type example: 'CONVERSIONS'.

Creates an async report task for large datasets or long date ranges. After calling this tool, immediately use check_async_report_tool with the returned task_id to monitor progress. When status is COMPLETE, use download_async_report_tool to retrieve the data. Inform the user that the report is being generated and you will check on it. report_type: BASIC | AUDIENCE. data_level: AUCTION_AD | AUCTION_ADGROUP | AUCTION_CAMPAIGN. Dates are YYYY-MM-DD.

Checks the status of an async report task created by create_async_report_tool. Status will be PROCESSING, COMPLETE, or FAILED. If PROCESSING, inform the user the report is still generating and check again shortly. When COMPLETE, call download_async_report_tool with the same task_id.

Downloads the completed data for an async report task. Only call after check_async_report_tool returns status COMPLETE. Returns the report rows.

Get estimated audience reach for given targeting criteria. NOTE: This endpoint requires allowlist access from TikTok. Contact TikTok support if you receive a 404 error. objective_type examples: 'TRAFFIC', 'CONVERSIONS', 'APP_INSTALL'. gender: 'GENDER_MALE' | 'GENDER_FEMALE' | 'GENDER_UNLIMITED'. Returns estimated_audience_size_lower, estimated_audience_size_upper, reach_trend.

Get all available interest categories for audience targeting. Returns a list of interest categories with their IDs, names, levels, and sub-category IDs. Use the returned interest_category_id values when setting up ad group targeting. Optionally filter by objective_type (e.g. 'TRAFFIC', 'CONVERSIONS').

List all TikTok Pixel installations for an advertiser. Shows which conversion events are being tracked and whether measurement is set up correctly. Returns pixel_id, pixel_name, pixel_code, status, create_time, and tracked events.

Get Smart+ (AI-optimised) campaigns for an advertiser. Smart+ campaigns do NOT appear in get_campaigns_tool — accounts using Smart+ have a blind spot without this tool. Returns campaign_id, name, status, budget, objective_type, create/modify times. status filter examples: 'ENABLE', 'DISABLE', 'DELETE'.

Get aggregated conversion event counts (Purchase, AddToCart, ViewContent, etc.) per pixel over a date range. Use after get_pixels_tool to get pixel_ids. Dates are YYYY-MM-DD. Returns one row per pixel per event type per day.

Browse the creative video asset library for an advertiser. Returns video_id, video_name, duration, width, height, cover_url, create_time, size. Optional filtering dict supports keys like 'video_name' for name search.

Get cash balance and credit limit for all advertiser accounts within a Business Center. Returns advertiser_id, balance, credit_limit, and currency for each account. Use get_business_centers_tool first to get bc_id.

Get all assets of a given type within a Business Center. asset_type must be one of: ADVERTISER, PIXEL, CATALOG. Returns asset_id, asset_name, asset_type, status for each asset. Use get_business_centers_tool first to get bc_id.

Get all members of a Business Center, their roles, and access status. Returns user_id, username, email, role, status for each member. Useful for access audits. Use get_business_centers_tool first to get bc_id.

List offline conversion event sets configured for an advertiser. Shows what offline events (e.g. in-store purchases, phone leads) are being matched back to TikTok ad exposure. Returns event_set_id, name, status, event_types, and create_time.