All skills
youtubetiktok Brand & Social Listening

Cross-Platform Video Share-of-Voice

Find the creators dominating your topic across YouTube and TikTok and rank them by reach and sentiment

Run this skill with your agent
1. Connect the MCP server
https://apidirect.io/mcp?token=YOUR_API_KEY
2. Then just say to your agent
Show me who owns the video conversation about {topic} on YouTube and TikTok in {region}
In clients that support MCP prompts (Claude Desktop, Claude Code, Cursor) this skill appears as a prompt named cross-platform-video-share-of-voice. Any agent can also call get_skill(skill_id="cross-platform-video-share-of-voice") to pull these steps on demand.

What it does

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.

Who it's for: Content and partnerships teams scouting the video landscape of a category

Inputs

Input Required Description Example
topic Yes Topic, product category, or branded keyword to track on video AI note-taking apps
region No 2-letter country code to scope TikTok results us

How your agent runs it

  1. 1
    search_youtube(query={topic}, pages=5, upload_date=this_month, get_sentiment=true)

    Collect this month's videos, the channels behind them, and per-video sentiment.

  2. 2
    search_youtube_channels(query={topic}, pages=2)

    Resolve subscriber_count for each channel to size its real YouTube reach.

  3. 3
    search_tiktok(query={topic}, pages=5, region={region}, publish_time=30, sort_by=most_liked, get_sentiment=true)

    Pull the most-liked recent TikToks on the topic and their sentiment.

  4. 4
    search_tiktok_users(query={topic}, pages=2)

    Resolve TikTok follower and video counts, then merge both platforms into one share-of-voice ranking by reach times positive sentiment.

Delivers: A unified video share-of-voice leaderboard of the top YouTube and TikTok creators on your topic, ranked by reach and sentiment, with each creator's platform skew

Tools used

The full playbook

This is exactly what the MCP returns to your agent (via the cross-platform-video-share-of-voice prompt or get_skill tool), with your inputs filled in.

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.

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>
  - region (optional): (optional — e.g. us)

STEPS:
  1. Tool `search_youtube` — search_youtube(query=<topic>, pages=5, upload_date=this_month, get_sentiment=true)
     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)
     Resolve subscriber_count for each channel to size its real YouTube reach.
  3. Tool `search_tiktok` — search_tiktok(query=<topic>, pages=5, region=<region>, publish_time=30, sort_by=most_liked, get_sentiment=true)
     Pull the most-liked recent TikToks on the topic and their sentiment.
  4. Tool `search_tiktok_users` — search_tiktok_users(query=<topic>, pages=2)
     Resolve TikTok follower and video counts, then merge both platforms into one share-of-voice ranking by reach times positive sentiment.

DELIVER: A unified video share-of-voice leaderboard of the top YouTube and TikTok creators on your topic, ranked by reach and 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.