Built by Metorial, the integration platform for agentic AI.
Retrieve the authenticated TikTok user's profile information including display name, avatar, bio, verification status, follower/following counts, and video count. The level of detail depends on the granted OAuth scopes.
Initialize a video post to the authenticated user's TikTok profile. Supports posting from a public URL or initializing a file upload. Returns a publish ID to track the post status and, for file uploads, an upload URL.
Create, update, or change the status of TikTok Ads campaigns. Supports creating a new campaign with objective type and budget settings, updating an existing campaign's name or budget, and enabling/disabling campaigns. Use the **action** field to specify the operation: - **create**: Create a new campaign - **update**: Update campaign name, budget, or budget mode - **updateStatus**: Enable, disable, or delete campaigns
Pull advertising performance reports from TikTok Ads Manager. Configure dimensions (how to group data), metrics (what data to retrieve), data level, and date range. Supports filtering by campaign, ad group, or ad. Common **dimensions**: `stat_time_day`, `stat_time_hour`, `campaign_id`, `adgroup_id`, `ad_id`, `country_code`. Common **metrics**: `spend`, `impressions`, `clicks`, `ctr`, `cpc`, `cpm`, `conversions`, `cost_per_conversion`, `reach`, `frequency`.
Retrieve TikTok Ads ad groups for an advertiser. Filter by campaign IDs or specific ad group IDs. Returns ad group details including targeting, budget, schedule, and optimization settings.
Retrieve TikTok ads for an advertiser. Filter by campaign IDs, ad group IDs, or specific ad IDs. Returns ad details including name, status, and timestamps.
Retrieve a paginated list of the authenticated user's public TikTok videos, sorted by creation time (newest first). Returns video metadata including engagement metrics, embed links, and cover images. Use cursor-based pagination to retrieve additional pages.
Retrieve TikTok Ads campaigns for an advertiser. Optionally filter by specific campaign IDs. Returns campaign details including name, objective, budget, status, and timestamps.
Look up specific TikTok videos by their IDs. Returns video metadata including cover image, engagement metrics, embed links, and dimensions. Useful for refreshing expired cover image URLs or fetching details for known videos.
Retrieve the authenticated creator's posting capabilities and constraints. Returns available privacy level options, interaction settings (comments, duet, stitch), and maximum video duration. **Must be called before posting content** to determine valid settings.
Check the status of a previously initiated content post on TikTok. Returns the current publishing stage, any failure reasons, and the public post ID once moderation is complete.
Create a new ad group within a TikTok Ads campaign. Configure targeting (location, age, gender), budget, schedule, bidding strategy, and optimization goal.
Initialize a photo post to the authenticated user's TikTok profile by providing publicly accessible image URLs. Returns a publish ID to track the post status.