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

Search TikTok, YouTube, Reddit, Pinterest, Threads, Instagram, and Google from one tool. Find creators, trending videos, hashtags, and discussions across the social web for influencer discovery, market research, and trend tracking.

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

## Skills (12)

### Search TikTok Users (`search_tiktok_users`)

Search for TikTok users matching a query. Returns user profiles with follower counts, bios, and verification status.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Search query string |

**Returns:** Array of TikTok user profiles with username, display name, follower count, and bio

**Examples:**

*Find TikTok creators in a niche:*

```json
{
  "query": "fitness coach"
}
```

### Search TikTok Keywords (`search_tiktok_keywords`)

Search TikTok videos by keyword. Returns videos with engagement metrics, captions, and author information.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Search query string |

**Returns:** Array of TikTok videos with description, play count, likes, shares, and author details

**Examples:**

*Search TikTok videos about a topic:*

```json
{
  "query": "morning routine productivity"
}
```

### Search TikTok Hashtags (`search_tiktok_hashtags`)

Search TikTok content by hashtag. Returns videos and hashtag metadata including view counts and trending status.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `hashtag` | string | Yes | Hashtag to search for (without the # symbol) |

**Returns:** Hashtag metadata with view count and related TikTok videos

**Examples:**

*Find TikTok content for a hashtag:*

```json
{
  "hashtag": "smallbusiness"
}
```

### Search TikTok Top Results (`search_tiktok_top`)

Get top TikTok search results for a query. Returns the highest-ranked mix of videos, users, and sounds.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Search query string |

**Returns:** Top-ranked TikTok results including videos, users, and sounds

**Examples:**

*Get top TikTok results for a trending topic:*

```json
{
  "query": "AI tools for creators"
}
```

### Search YouTube (`search_youtube`)

Search YouTube for videos, channels, and playlists. Returns results with titles, view counts, and channel information.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Search query string |

**Returns:** Array of YouTube results with title, view count, channel name, duration, and thumbnail

**Examples:**

*Search YouTube for tutorial content:*

```json
{
  "query": "React Server Components tutorial"
}
```

### Search YouTube Hashtag (`search_youtube_hashtag`)

Search YouTube content by hashtag. Returns videos tagged with the specified hashtag and their engagement metrics.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `hashtag` | string | Yes | Hashtag to search for (without the # symbol) |

**Returns:** Array of YouTube videos tagged with the hashtag, including title, views, and channel

**Examples:**

*Find YouTube videos with a hashtag:*

```json
{
  "hashtag": "webdev"
}
```

### Search Reddit (`search_reddit`)

Search Reddit posts and communities. Returns posts with titles, scores, comment counts, and subreddit information.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Search query string |

**Returns:** Array of Reddit posts with title, score, comment count, subreddit, and permalink

**Examples:**

*Search Reddit for discussions on a topic:*

```json
{
  "query": "best IDE for TypeScript development"
}
```

### Search Pinterest (`search_pinterest`)

Search Pinterest for pins. Returns pins with images, descriptions, save counts, and board information.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Search query string |

**Returns:** Array of Pinterest pins with image URL, description, save count, and source link

**Examples:**

*Search Pinterest for design inspiration:*

```json
{
  "query": "minimalist home office design"
}
```

### Search Threads Users (`search_threads_users`)

Search for users on Threads. Returns user profiles with follower counts, bios, and verification status.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Search query string |

**Returns:** Array of Threads user profiles with username, display name, follower count, and bio

**Examples:**

*Find users on Threads:*

```json
{
  "query": "tech journalist"
}
```

### Search Google (`search_google`)

Search Google and get structured results. Returns organic listings, knowledge panels, and related searches.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Search query string |

**Returns:** Structured Google search results with organic listings, knowledge graph, and related searches

**Examples:**

*Search Google for a topic:*

```json
{
  "query": "latest machine learning frameworks 2026"
}
```

### Search Instagram Reels (`search_instagram_reels`)

Search for Instagram reels by keyword. Uses Google Search to find reels since Instagram search requires login.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Search query string |

**Returns:** Array of Instagram reels matching the keyword with video URLs, captions, and engagement

**Examples:**

*Search for Instagram reels about a topic:*

```json
{
  "query": "cooking recipes"
}
```

### Search Reddit Subreddit (`search_reddit_subreddit`)

Search within a specific subreddit for posts, comments, or media matching a query. Filter by sort order and timeframe.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `subreddit` | string | Yes | Subreddit name without the r/ prefix |
| `query` | string | No | Search query string |
| `sort` | string | No | Sort order for results (e.g. relevance, hot, new, top) |
| `timeframe` | string | No | Time filter (e.g. hour, day, week, month, year, all) |

**Returns:** Array of Reddit posts within the subreddit matching the query

**Examples:**

*Search a subreddit for a topic:*

```json
{
  "subreddit": "programming",
  "query": "TypeScript tips"
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call social-media-search search_tiktok_users --query fitness coach

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"social-media-search","skill":"search_tiktok_users","input":{"query":"fitness coach"}}' \
     https://api.toolrouter.com/v1/tools/call
```

## Frequently Asked Questions

### How do I choose between creators, hashtags, and posts?

Use the creator search when you are building an influencer list, hashtag search when you are tracking a trend, and keyword search when you want specific videos or discussions around a topic.

### Can I search more than one platform from the same tool?

Yes. It covers TikTok, YouTube, Reddit, Pinterest, Threads, Instagram reels, and Google, so you can compare how the same topic shows up across different surfaces.

### What does the top TikTok search result give me?

`search_tiktok_top` returns the strongest mix of videos, users, and sounds for a query, which is useful when you want the broadest read on what is ranking.

### Can I search inside a subreddit?

Yes. `search_reddit_subreddit` lets you query within a specific subreddit and filter by sort order and timeframe, which is better than a broad Reddit search when you already know the community.

---

## 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