Social Media Content — Posts & videos from 10+ platforms

Tools / Social Media Content

Get TikTok Videos

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

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

Parameters

handle *stringUsername or handle of the account (without @ prefix)

Example

Get videos from a TikTok creator

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_tiktok_videos",
  "input": {
    "handle": "charlidamelio"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get TikTok Video

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get details of a TikTok video

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_tiktok_video",
  "input": {
    "url": "https://www.tiktok.com/@charlidamelio/video/7234567890123456789"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get TikTok Live

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

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

Parameters

handle *stringUsername or handle of the account (without @ prefix)

Example

Check if a TikTok user is live

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_tiktok_live",
  "input": {
    "handle": "charlidamelio"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Instagram Posts

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

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

Parameters

handle *stringUsername or handle of the account (without @ prefix)

Example

Get posts from an Instagram account

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_instagram_posts",
  "input": {
    "handle": "natgeo"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Instagram Reels

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

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

Parameters

handle *stringUsername or handle of the account (without @ prefix)

Example

Get reels from an Instagram creator

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_instagram_reels",
  "input": {
    "handle": "natgeo"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Instagram Highlights

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

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

Parameters

handle *stringUsername or handle of the account (without @ prefix)

Example

Get story highlights from an Instagram profile

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_instagram_highlights",
  "input": {
    "handle": "natgeo"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Instagram Post

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get details of an Instagram post

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_instagram_post",
  "input": {
    "url": "https://www.instagram.com/p/ABC123def456/"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get YouTube Videos

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

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

Parameters

handle *stringUsername or handle of the account (without @ prefix)

Example

Get videos from a YouTube channel

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_youtube_videos",
  "input": {
    "handle": "mkbhd"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get YouTube Shorts

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

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

Parameters

handle *stringUsername or handle of the account (without @ prefix)

Example

Get shorts from a YouTube channel

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_youtube_shorts",
  "input": {
    "handle": "mkbhd"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get YouTube Video

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get details of a YouTube video

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_youtube_video",
  "input": {
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get YouTube Playlist

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

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

Parameters

playlist_id *stringYouTube playlist ID (e.g. PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf)

Example

Get videos from a YouTube playlist

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_youtube_playlist",
  "input": {
    "playlist_id": "PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get YouTube Community Post

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get a YouTube community post

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_youtube_community_post",
  "input": {
    "url": "https://www.youtube.com/post/Ugkx1234567890abcdef"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Twitter Tweets

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

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

Parameters

handle *stringUsername or handle of the account (without @ prefix)

Example

Get tweets from a Twitter user

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_twitter_tweets",
  "input": {
    "handle": "elonmusk"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Twitter Tweet

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get details of a specific tweet

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_twitter_tweet",
  "input": {
    "url": "https://x.com/elonmusk/status/1234567890123456789"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Facebook Posts

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get posts from a Facebook page

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_facebook_posts",
  "input": {
    "url": "https://www.facebook.com/NASA"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Facebook Reels

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get reels from a Facebook page

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_facebook_reels",
  "input": {
    "url": "https://www.facebook.com/NASA"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Facebook Photos

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get photos from a Facebook page

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_facebook_photos",
  "input": {
    "url": "https://www.facebook.com/NASA"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Facebook Post

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get details of a Facebook post

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_facebook_post",
  "input": {
    "url": "https://www.facebook.com/NASA/posts/1234567890"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Facebook Group Posts

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get posts from a Facebook group

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_facebook_group_posts",
  "input": {
    "url": "https://www.facebook.com/groups/reactjs"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get LinkedIn Post

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get details of a LinkedIn post

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_linkedin_post",
  "input": {
    "url": "https://www.linkedin.com/posts/satyanadella_activity-1234567890"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Threads Post

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get details of a Threads post

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_threads_post",
  "input": {
    "url": "https://www.threads.net/@zuck/post/ABC123def456"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Bluesky Post

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get details of a Bluesky post

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_bluesky_post",
  "input": {
    "url": "https://bsky.app/profile/jay.bsky.team/post/3abc123def456"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Twitch Clip

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get details of a Twitch clip

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_twitch_clip",
  "input": {
    "url": "https://clips.twitch.tv/ExampleClipName-AbCdEfGhIj123"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Kick Clip

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get details of a Kick clip

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_kick_clip",
  "input": {
    "url": "https://kick.com/streamer/clips/clip_ABC123"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Pinterest Pin

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get details of a Pinterest pin

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_pinterest_pin",
  "input": {
    "url": "https://www.pinterest.com/pin/1234567890/"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Pinterest Board

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get pins from a Pinterest board

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_pinterest_board",
  "input": {
    "url": "https://www.pinterest.com/user/board-name/"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Pinterest User Boards

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

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

Parameters

handle *stringUsername or handle of the account (without @ prefix)

Example

Get boards from a Pinterest user

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_pinterest_boards",
  "input": {
    "handle": "pinterest"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Truth Social Post

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get a Truth Social post

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_truthsocial_post",
  "input": {
    "url": "https://truthsocial.com/@realDonaldTrump/posts/123456789"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Truth Social User Posts

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

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

Parameters

handle *stringUsername or handle of the account (without @ prefix)

Example

Get posts from a Truth Social user

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_truthsocial_posts",
  "input": {
    "handle": "realDonaldTrump"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Threads User Posts

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

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

Parameters

handle *stringUsername or handle of the account (without @ prefix)

Example

Get posts from a Threads user

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_threads_posts",
  "input": {
    "handle": "zuck"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Bluesky User Posts

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

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

Parameters

handle *stringUsername or handle of the account (without @ prefix)

Example

Get posts from a Bluesky user

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_bluesky_posts",
  "input": {
    "handle": "jay.bsky.team"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get LinkedIn Company Posts

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get posts from a LinkedIn company

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_linkedin_company_posts",
  "input": {
    "url": "https://www.linkedin.com/company/google/"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Twitter Community

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get a Twitter community

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_twitter_community",
  "input": {
    "url": "https://x.com/i/communities/1234567890"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Twitter Community Tweets

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

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

Parameters

url *stringFull URL of the post, video, or content

Example

Get tweets from a Twitter community

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_twitter_community_tweets",
  "input": {
    "url": "https://x.com/i/communities/1234567890"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Instagram Highlight Detail

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

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

Parameters

id *stringInstagram highlight ID

Example

Get media from an Instagram highlight

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-media-content",
  "skill": "get_instagram_highlight_detail",
  "input": {
    "id": "17890534567890123"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Quick Start

MCP (Claude Code)

claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp

REST API

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"social-media-content","skill":"get_tiktok_videos","input":{}}' \
  https://api.toolrouter.com/v1/tools/call

Use Cases

Open Analyze Competitor Content Strategy

Analyze Competitor Content Strategy

Pull competitor posts and videos across platforms to reverse-engineer their content strategy.

Social Media Content4 agent guides

Open Research Viral Post Formats

Research Viral Post Formats

Study top-performing posts and videos to identify which content formats go viral in your niche.

Social Media Content4 agent guides

Open Search Papers by Topic

Search Papers by Topic

Find relevant academic papers on any research topic across millions of scholarly publications.

Academic Research4 agent guides

Open Geocode Addresses to Coordinates

Geocode Addresses to Coordinates

Convert street addresses into precise latitude and longitude coordinates for mapping and spatial analysis.

Address Geocoding4 agent guides

View all use cases for Social Media Content→

Workflows

Open Full-Funnel Ad Research

Full-Funnel Ad Research

Research competitor advertising across platforms, analyze their strategy, study their organic content, and generate your own ad creatives.

Ad Library Search

Competitor Research

Social Media Content

Generate Image

4 steps4 tools

Open Social Media Growth Kit

Social Media Growth Kit

Accelerate social media growth by auditing your profiles, discovering trends, analyzing top content, and generating visuals.

Social Profiles

Brand Identity Builder

Build and maintain a cohesive brand identity by extracting brand elements, managing logos, generating on-brand visuals, and auditing consistency.

Brand Extract

Get Brand Logo

Generate Image

Social Media Content

4 steps4 tools

Open Product Launch Media Kit

Product Launch Media Kit

Prepare a product launch media kit with professional visuals, campaign research, and press coverage analysis.

Generate Image

Social Media Content

Web Search

3 steps3 tools

View all 14workflows →

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.