Skip to main content

Overview

The yoinkit skill provides five main commands for social media research:
CommandDescription
transcriptExtract transcript from any video URL
contentGet full content and metadata from any social post
searchSearch for content on a specific platform
trendingGet currently trending content
researchCompound command for automated research workflows

transcript

Extract transcript/captions from video content.

Syntax

yoinkit transcript <url>

Supported Platforms

  • YouTube videos
  • TikTok videos
  • Instagram Reels
  • Facebook videos
  • Twitch clips

Examples

yoinkit transcript https://youtube.com/watch?v=abc123
yoinkit transcript https://tiktok.com/@user/video/123
yoinkit transcript https://instagram.com/reel/xyz

Output

Returns plain text transcript with optional speaker labels (when available).

content

Get full content and metadata from any social post.

Syntax

yoinkit content <url>

Supported Platforms

All 14 platforms: YouTube, TikTok, Instagram, Twitter/X, Reddit, LinkedIn, Facebook, Twitch, Kick, Snapchat, Pinterest, Threads, Bluesky, Rumble

Examples

yoinkit content https://twitter.com/user/status/123
yoinkit content https://reddit.com/r/sub/comments/abc
yoinkit content https://linkedin.com/posts/user-activity-123

Output

Returns structured data including:
  • Post body/description
  • Engagement metrics (likes, shares, comments)
  • Author information
  • Publish date
  • Platform-specific metadata

Search for content on a specific platform.

Syntax

yoinkit search <platform> "<query>" [options]

Options

OptionDescription
--limitNumber of results (default: 10)
--sortSort order: relevance, date, views
--timeTime filter: hour, day, week, month, year

Examples

yoinkit search youtube "AI tools for creators"
yoinkit search tiktok "productivity tips" --limit 20
yoinkit search reddit "home automation" --subreddit technology --sort top
yoinkit search twitter "startup funding" --time week

Output

Returns list of results with links, engagement metrics, and metadata.
Get currently trending content on a platform.

Syntax

yoinkit trending <platform> [options]

Options

OptionDescription
--categoryFilter by category (YouTube)
--countryCountry code (default: US)
--limitNumber of results (default: 20)

Examples

yoinkit trending youtube --category tech
yoinkit trending tiktok --country US
yoinkit trending twitter
yoinkit trending reddit --subreddit technology

Output

Returns ranked list of trending content with metrics.

research

Compound command — Automated research workflow that combines multiple API calls.

Syntax

yoinkit research "<topic>" [options]

Options

OptionDescription
--platformsComma-separated list (default: youtube,tiktok,twitter)
--depthResearch depth: quick, normal, deep
--transcriptsPull transcripts from top videos (deep only)

Examples

yoinkit research "home automation"
yoinkit research "AI tools" --platforms youtube,tiktok,reddit --depth deep
yoinkit research "fitness trends" --depth quick

What It Does

  1. Searches each platform for the topic
  2. Gets trending content in that space
  3. (Deep mode) Pulls transcripts from top videos
  4. Summarizes themes and angles
  5. Identifies content opportunities

Output

Returns a structured research report:
## Research Report: Home Automation

### Trending Topics
- Smart home security (YouTube, TikTok)
- Matter protocol updates (Reddit, Twitter)
- Budget automation setups (TikTok)

### Top Content This Week
1. "I Automated My Entire House for $500" (YouTube, 1.2M views)
   - Key angles: budget-friendly, DIY, beginner-focused

### Content Opportunities
- Gap: No recent content on "Matter + HomeKit integration"
- Trending format: "Day in my automated life" vlogs

Platform Support

Not all platforms support all commands. Here’s what works where:
PlatformTranscriptContentTrendingSearch
YouTube
TikTok
Instagram✅ (reels)
Twitter/X
Reddit
LinkedIn
Facebook
Twitch
Kick
Snapchat
Pinterest
Threads
Bluesky
Truth Social
Transcripts require video/audio content. Text-based platforms (Twitter, Reddit, LinkedIn) don’t have transcripts — use content instead.
Trending by topic isn’t available on most platforms. Trending returns overall hot content. For topic-specific research, use search with time filters.

Natural Language

You don’t have to use exact command syntax. Your AI assistant understands natural language:
“Get the transcript from this YouTube video”
“What did they say in this TikTok?”
“Transcribe this Instagram reel for me”
Your assistant translates your request into the appropriate API calls and handles platform limitations automatically.