---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/social-media-content
---
# Social Media Content

Pull structured post and video data from TikTok, Instagram, YouTube, Twitter/X, Facebook, LinkedIn, Threads, Bluesky, Twitch, Kick, Pinterest, and Truth Social. Get captions, engagement metrics, media URLs, and timestamps for content research and competitor monitoring.

- **Version:** 0.02
- **Categories:** data, media

## Skills (35)

### Get TikTok Videos (`get_tiktok_videos`)

Get videos posted by a TikTok user including captions, view counts, and engagement metrics.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Username or handle of the account (without @ prefix) |

**Returns:** Array of TikTok videos with captions, view counts, likes, comments, and shares

**Examples:**

*Get videos from a TikTok creator:*

```json
{
  "handle": "charlidamelio"
}
```

### Get TikTok Video (`get_tiktok_video`)

Get details of a specific TikTok video including caption, stats, and audio information.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** TikTok video details with caption, author, view count, likes, comments, shares, and audio info

**Examples:**

*Get details of a TikTok video:*

```json
{
  "url": "https://www.tiktok.com/@charlidamelio/video/7234567890123456789"
}
```

### Get TikTok Live (`get_tiktok_live`)

Get live stream information for a TikTok user including stream status and viewer count.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Username or handle of the account (without @ prefix) |

**Returns:** TikTok live stream info with status, title, viewer count, and stream details

**Examples:**

*Check if a TikTok user is live:*

```json
{
  "handle": "charlidamelio"
}
```

### Get Instagram Posts (`get_instagram_posts`)

Get posts from an Instagram user including images, captions, likes, and comments.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Username or handle of the account (without @ prefix) |

**Returns:** Array of Instagram posts with images, captions, like counts, and comment counts

**Examples:**

*Get posts from an Instagram account:*

```json
{
  "handle": "natgeo"
}
```

### Get Instagram Reels (`get_instagram_reels`)

Get reels from an Instagram user including video details, views, and engagement metrics.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Username or handle of the account (without @ prefix) |

**Returns:** Array of Instagram reels with video URLs, view counts, likes, and comments

**Examples:**

*Get reels from an Instagram creator:*

```json
{
  "handle": "natgeo"
}
```

### Get Instagram Highlights (`get_instagram_highlights`)

Get story highlights from an Instagram user including highlight covers and titles.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Username or handle of the account (without @ prefix) |

**Returns:** Array of Instagram story highlights with titles, cover images, and media items

**Examples:**

*Get story highlights from an Instagram profile:*

```json
{
  "handle": "natgeo"
}
```

### Get Instagram Post (`get_instagram_post`)

Get details of a specific Instagram post or reel including media, caption, and engagement.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** Instagram post details with media URLs, caption, author, likes, comments, and timestamp

**Examples:**

*Get details of an Instagram post:*

```json
{
  "url": "https://www.instagram.com/p/ABC123def456/"
}
```

### Get YouTube Videos (`get_youtube_videos`)

Get videos from a YouTube channel including titles, view counts, and publish dates.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Username or handle of the account (without @ prefix) |

**Returns:** Array of YouTube videos with titles, view counts, durations, thumbnails, and publish dates

**Examples:**

*Get videos from a YouTube channel:*

```json
{
  "handle": "mkbhd"
}
```

### Get YouTube Shorts (`get_youtube_shorts`)

Get shorts from a YouTube channel including titles, view counts, and thumbnails.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Username or handle of the account (without @ prefix) |

**Returns:** Array of YouTube shorts with titles, view counts, thumbnails, and publish dates

**Examples:**

*Get shorts from a YouTube channel:*

```json
{
  "handle": "mkbhd"
}
```

### Get YouTube Video (`get_youtube_video`)

Get details of a specific YouTube video including title, description, stats, and channel info.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** YouTube video details with title, description, view count, likes, channel, duration, and publish date

**Examples:**

*Get details of a YouTube video:*

```json
{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}
```

### Get YouTube Playlist (`get_youtube_playlist`)

Get videos from a YouTube playlist including titles, channels, and video order.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `playlist_id` | string | Yes | YouTube playlist ID (e.g. PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf) |

**Returns:** Array of playlist videos with titles, channels, durations, and positions

**Examples:**

*Get videos from a YouTube playlist:*

```json
{
  "playlist_id": "PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf"
}
```

### Get YouTube Community Post (`get_youtube_community_post`)

Get a YouTube community post including text content, images, polls, and engagement.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** YouTube community post with text, images, poll data, likes, and comments

**Examples:**

*Get a YouTube community post:*

```json
{
  "url": "https://www.youtube.com/post/Ugkx1234567890abcdef"
}
```

### Get Twitter Tweets (`get_twitter_tweets`)

Get tweets from a Twitter/X user including text, media, likes, retweets, and replies.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Username or handle of the account (without @ prefix) |

**Returns:** Array of tweets with text, media, like count, retweet count, reply count, and timestamp

**Examples:**

*Get tweets from a Twitter user:*

```json
{
  "handle": "elonmusk"
}
```

### Get Twitter Tweet (`get_twitter_tweet`)

Get details of a specific tweet including text, media, engagement metrics, and replies.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** Tweet details with text, author, media, likes, retweets, replies, quotes, and timestamp

**Examples:**

*Get details of a specific tweet:*

```json
{
  "url": "https://x.com/elonmusk/status/1234567890123456789"
}
```

### Get Facebook Posts (`get_facebook_posts`)

Get posts from a Facebook profile including text, media, reactions, and comments.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** Array of Facebook posts with text, media, reaction counts, comments, and shares

**Examples:**

*Get posts from a Facebook page:*

```json
{
  "url": "https://www.facebook.com/NASA"
}
```

### Get Facebook Reels (`get_facebook_reels`)

Get reels from a Facebook profile including video details, views, and reactions.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** Array of Facebook reels with video URLs, view counts, reactions, and comments

**Examples:**

*Get reels from a Facebook page:*

```json
{
  "url": "https://www.facebook.com/NASA"
}
```

### Get Facebook Photos (`get_facebook_photos`)

Get photos from a Facebook profile including image URLs, captions, and reactions.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** Array of Facebook photos with image URLs, captions, reaction counts, and comments

**Examples:**

*Get photos from a Facebook page:*

```json
{
  "url": "https://www.facebook.com/NASA"
}
```

### Get Facebook Post (`get_facebook_post`)

Get details of a specific Facebook post including text, media, reactions, and comments.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** Facebook post details with text, media, author, reactions, comments, shares, and timestamp

**Examples:**

*Get details of a Facebook post:*

```json
{
  "url": "https://www.facebook.com/NASA/posts/1234567890"
}
```

### Get Facebook Group Posts (`get_facebook_group_posts`)

Get posts from a Facebook group including text, media, reactions, and member activity.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** Array of Facebook group posts with text, author, media, reactions, comments, and timestamp

**Examples:**

*Get posts from a Facebook group:*

```json
{
  "url": "https://www.facebook.com/groups/reactjs"
}
```

### Get LinkedIn Post (`get_linkedin_post`)

Get details of a specific LinkedIn post including text, media, reactions, and comments.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** LinkedIn post details with text, author, media, reaction counts, comments, and reposts

**Examples:**

*Get details of a LinkedIn post:*

```json
{
  "url": "https://www.linkedin.com/posts/satyanadella_activity-1234567890"
}
```

### Get Threads Post (`get_threads_post`)

Get details of a specific Threads post including text, media, likes, and replies.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** Threads post details with text, author, media, like count, reply count, and timestamp

**Examples:**

*Get details of a Threads post:*

```json
{
  "url": "https://www.threads.net/@zuck/post/ABC123def456"
}
```

### Get Bluesky Post (`get_bluesky_post`)

Get details of a specific Bluesky post including text, media, likes, and reposts.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** Bluesky post details with text, author, media, like count, repost count, and timestamp

**Examples:**

*Get details of a Bluesky post:*

```json
{
  "url": "https://bsky.app/profile/jay.bsky.team/post/3abc123def456"
}
```

### Get Twitch Clip (`get_twitch_clip`)

Get details of a Twitch clip including title, streamer, game, duration, and view count.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** Twitch clip details with title, streamer, game, duration, view count, and thumbnail

**Examples:**

*Get details of a Twitch clip:*

```json
{
  "url": "https://clips.twitch.tv/ExampleClipName-AbCdEfGhIj123"
}
```

### Get Kick Clip (`get_kick_clip`)

Get details of a Kick clip including title, streamer, category, duration, and view count.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** Kick clip details with title, streamer, category, duration, view count, and thumbnail

**Examples:**

*Get details of a Kick clip:*

```json
{
  "url": "https://kick.com/streamer/clips/clip_ABC123"
}
```

### Get Pinterest Pin (`get_pinterest_pin`)

Get details of a Pinterest pin including image, description, saves, and source link.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** Pinterest pin details with image URL, title, description, save count, and source link

**Examples:**

*Get details of a Pinterest pin:*

```json
{
  "url": "https://www.pinterest.com/pin/1234567890/"
}
```

### Get Pinterest Board (`get_pinterest_board`)

Get all pins from a Pinterest board including images, descriptions, and save counts.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** Array of pins from the board with image URLs, titles, descriptions, and save counts

**Examples:**

*Get pins from a Pinterest board:*

```json
{
  "url": "https://www.pinterest.com/user/board-name/"
}
```

### Get Pinterest User Boards (`get_pinterest_boards`)

Get all boards from a Pinterest user including board names, pin counts, and cover images.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Username or handle of the account (without @ prefix) |

**Returns:** Array of Pinterest boards with names, descriptions, pin counts, and cover images

**Examples:**

*Get boards from a Pinterest user:*

```json
{
  "handle": "pinterest"
}
```

### Get Truth Social Post (`get_truthsocial_post`)

Get details of a specific Truth Social post including text, media, and engagement metrics.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** Truth Social post details with text, media, author, likes, reposts, and timestamp

**Examples:**

*Get a Truth Social post:*

```json
{
  "url": "https://truthsocial.com/@realDonaldTrump/posts/123456789"
}
```

### Get Truth Social User Posts (`get_truthsocial_posts`)

Get posts from a Truth Social user. Currently limited to prominent/verified users by the platform.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Username or handle of the account (without @ prefix) |

**Returns:** Array of Truth Social posts with text, media, likes, reposts, and timestamps

**Examples:**

*Get posts from a Truth Social user:*

```json
{
  "handle": "realDonaldTrump"
}
```

### Get Threads User Posts (`get_threads_posts`)

Get posts from a Threads user. Returns the most recent 20-30 posts (platform limitation).

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Username or handle of the account (without @ prefix) |

**Returns:** Array of Threads posts with text, media, likes, replies, and timestamps

**Examples:**

*Get posts from a Threads user:*

```json
{
  "handle": "zuck"
}
```

### Get Bluesky User Posts (`get_bluesky_posts`)

Get posts from a Bluesky user including text, media, likes, and reposts.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Username or handle of the account (without @ prefix) |

**Returns:** Array of Bluesky posts with text, media, like count, repost count, and timestamps

**Examples:**

*Get posts from a Bluesky user:*

```json
{
  "handle": "jay.bsky.team"
}
```

### Get LinkedIn Company Posts (`get_linkedin_company_posts`)

Get posts from a LinkedIn company page. Limited to 7 pages of results (platform limitation).

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** Array of LinkedIn company posts with text, media, reactions, comments, and timestamps

**Examples:**

*Get posts from a LinkedIn company:*

```json
{
  "url": "https://www.linkedin.com/company/google/"
}
```

### Get Twitter Community (`get_twitter_community`)

Get details of a Twitter/X Community including name, description, member count, and rules.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** Twitter community details with name, description, member count, and rules

**Examples:**

*Get a Twitter community:*

```json
{
  "url": "https://x.com/i/communities/1234567890"
}
```

### Get Twitter Community Tweets (`get_twitter_community_tweets`)

Get tweets from a Twitter/X Community including text, media, and engagement metrics.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the post, video, or content |

**Returns:** Array of community tweets with text, author, media, likes, retweets, and timestamps

**Examples:**

*Get tweets from a Twitter community:*

```json
{
  "url": "https://x.com/i/communities/1234567890"
}
```

### Get Instagram Highlight Detail (`get_instagram_highlight_detail`)

Get the full media items from a specific Instagram story highlight by its ID.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `id` | string | Yes | Instagram highlight ID |

**Returns:** Highlight detail with all media items including images, videos, and timestamps

**Examples:**

*Get media from an Instagram highlight:*

```json
{
  "id": "17890534567890123"
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call social-media-content get_tiktok_videos --handle charlidamelio

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"social-media-content","skill":"get_tiktok_videos","input":{"handle":"charlidamelio"}}' \
     https://api.toolrouter.com/v1/tools/call
```

## Frequently Asked Questions

### Do I use a profile handle or a post URL?

Use handle-based skills when you want recent posts from an account. Use URL-based skills when you want one specific post, video, reel, or tweet pulled by link.

### Can I pull Instagram stories and highlights?

Yes. Instagram highlights are covered with a two-step flow: fetch the highlights first, then drill into a specific highlight with its ID.

### What do I get back besides the caption?

The content tools return engagement data such as likes, views, comments, and shares along with media URLs and timestamps, so you can compare performance, not just copy.

### Can I pull YouTube playlists or live TikTok data?

Yes. YouTube has dedicated video and playlist lookups, and TikTok includes both video and live-stream surfaces, which is useful when you need the full content footprint for an account.

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs