Tools / Social Reader

Read URL

Paste any social media URL — auto-detects the platform and content type and returns structured data. Falls back to clean markdown for unrecognized URLs.

Returns: Structured content from the detected platform, or clean markdown for web pages. Includes detected_platform and detected_type metadata.

Parameters

url *stringFull URL to read

Example

Read a tweet

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

Read Profile

Get profile data for any social media account by username and platform. Returns bio, follower counts, engagement metrics, and profile details.

Returns: Profile data including bio, follower/following counts, engagement metrics, and profile media

Parameters

handle *stringUsername or handle (without @ prefix)

platform *stringPlatform: tiktok, instagram, youtube, twitter, linkedin, facebook, reddit, threads, bluesky, truthsocial, snapchat, twitch

Example

Get a TikTok profile

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

Read Posts

Get recent posts from any social media account. Supports content type filtering: Instagram (posts, reels, highlights), YouTube (videos, shorts), Facebook (posts, reels, photos).

Returns: Array of posts with captions, engagement metrics, media URLs, and timestamps

Parameters

handle *stringUsername, handle, or identifier

platform *stringPlatform

content_typestringContent type filter. Instagram: posts, reels, highlights. YouTube: videos, shorts. Facebook: posts, reels, photos.

Example

Get Instagram posts

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

Read Comments

Get the comment thread for any post URL. Supports TikTok, YouTube, Instagram, Facebook, Reddit, Twitter, and Threads.

Returns: Comments with author info, text, likes/upvotes, timestamps, and nested replies

Parameters

url *stringFull URL to read

Example

Get comments on a YouTube video

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

Search Posts

Search for content across social platforms. Specify a platform for focused search, or omit to search TikTok, YouTube, Twitter, and Reddit simultaneously.

Returns: Search results with content, authors, and engagement metrics. Multi-platform search returns results grouped by platform.

Parameters

query *stringSearch query

platformstringLimit to one platform. Omit for multi-platform search.

search_typestringType of search: posts (default), users, hashtags.

Example

Search TikTok for cooking videos

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-reader",
  "skill": "search_posts",
  "input": {
    "query": "cooking tips",
    "platform": "tiktok"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Trending

Get trending content. TikTok: videos, songs, hashtags, creators, or For You feed. YouTube: trending Shorts.

Returns: Trending content with engagement metrics, sorted by popularity

Parameters

platform *stringPlatform: tiktok or youtube

trending_typestringTikTok: videos, songs, hashtags, creators, feed. YouTube: shorts.

countrystringISO country code (e.g. US, GB)

periodstringTime period in days: 1, 7, or 30

Example

Get trending TikTok videos

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

Read Feed

Parse any RSS or Atom feed URL. Returns structured feed items with titles, links, descriptions, dates, and authors.

Returns: Feed metadata and array of items with title, link, description, published date, and author

Parameters

url *stringRSS or Atom feed URL

Example

Read a blog RSS feed

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-reader",
  "skill": "read_feed",
  "input": {
    "url": "https://blog.example.com/feed.xml"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Read Webpage

Read any web page as clean markdown text. Strips navigation, ads, and boilerplate to extract the main content.

Returns: Clean markdown text of the main page content

Parameters

url *stringFull URL of the web page to read

Example

Read a news article

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "social-reader",
  "skill": "read_webpage",
  "input": {
    "url": "https://www.bbc.com/news/technology-12345678"
  }
}' \
  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-reader","skill":"read_url","input":{}}' \
  https://api.toolrouter.com/v1/tools/call