Cross-Platform Video Share-of-Voice

SKILL: Cross-Platform Video Share-of-Voice
Video is where category narratives form; pairing each platform's content search with its creator-resolver gives true subscriber and follower counts, so you can rank who actually owns the conversation rather than who posted most. It spans YouTube, TikTok, and Instagram Reels for full short-form coverage, with the user choosing exactly which platforms execute.

You are running this skill on API Direct via its MCP tools. Execute the steps below yourself by calling the named tools in order — values in <angle brackets> come from a previous step. Then deliver the result described at the end.

INPUTS:
  - topic (required): <topic — ASK THE USER>
      Topic, product category, or branded keyword to track on video
  - region (optional): (optional — e.g. us)
      2-letter country code to scope TikTok results
  - platforms (optional): (optional — e.g. youtube, tiktok, instagram)
      Comma-separated list of platforms to run — options: youtube, tiktok, instagram. Omit to run all of them; name specific platforms to limit the run.
  - depth (optional): 5 (default — override if you like)
      How many pages of content to pull per platform (controls result volume and cost). Defaults to 5.
  - tiktok_sort (optional): most_liked (default — override if you like)
      How to rank the TikTok pull: most_liked (reach), most_recent (freshness), or relevance. Defaults to most_liked.

PLATFORM SELECTION: some steps are gated with "Only run if {platforms} includes X". If the user supplied a `platforms` value, run only the steps whose platform is listed. If the user did NOT supply `platforms`, run ALL steps — every platform the skill supports.

STEPS:
  1. Tool `search_youtube` — search_youtube(query={topic}, pages=5, upload_date=this_month, get_sentiment=true)
     Only run if {platforms} includes youtube: collect this month's videos, the channels behind them, and per-video sentiment.
  2. Tool `search_youtube_channels` — search_youtube_channels(query={topic}, pages=2)
     Only run if {platforms} includes youtube: resolve subscriber_count for each channel to size its real YouTube reach.
  3. Tool `search_tiktok` — search_tiktok(query={topic}, pages=5, publish_time=30, sort_by=most_liked, get_sentiment=true)
     Only run if {platforms} includes tiktok: pull recent TikToks on the topic (most_liked by default) with sentiment, scoped to {region}.
  4. Tool `search_tiktok_users` — search_tiktok_users(query={topic}, pages=2)
     Only run if {platforms} includes tiktok: resolve TikTok follower and video counts, then merge every platform run so far into one share-of-voice ranking by reach times positive sentiment.
  5. Tool `search_instagram` — search_instagram(query={topic}, pages=5, get_sentiment=true)
     Only run if {platforms} includes instagram: pull recent Instagram Reels and posts on the topic with per-post sentiment to capture short-form video reach.
  6. Tool `search_instagram_users` — search_instagram_users(query={topic})
     Only run if {platforms} includes instagram: resolve each creator's Instagram follower count, then fold Instagram into the unified reach-times-sentiment leaderboard alongside YouTube and TikTok, tagging each creator's platform skew.

DELIVER: A unified video share-of-voice leaderboard of the top YouTube, TikTok, and (optionally) Instagram creators on your topic, ranked by reach times positive sentiment, with each creator's platform skew.

Note: each underlying tool call is billed at its normal endpoint price; get_sentiment adds a small per-page surcharge. Page through results as needed but stop once you have enough to deliver the outcome.