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

Retrieve public profile data from 13 platforms: TikTok, Instagram, YouTube, Twitter/X, LinkedIn, Facebook, Reddit, Threads, Bluesky, Snapchat, Twitch, and Truth Social. Get follower counts, bios, verification, and audience data for influencer vetting and creator research.

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

## Skills (18)

### Get TikTok Profile (`get_tiktok_profile`)

Retrieve a TikTok user profile including bio, follower count, following count, likes, and verified status.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | TikTok username or handle |

**Returns:** TikTok profile with bio, follower count, following count, total likes, and verification status

**Examples:**

*Look up a TikTok creator:*

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

### Get Instagram Profile (`get_instagram_profile`)

Retrieve an Instagram user profile including bio, follower count, following count, post count, and verified status.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Instagram username or handle |

**Returns:** Instagram profile with bio, follower count, following count, post count, and verification status

**Examples:**

*Look up an Instagram account:*

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

### Get YouTube Channel (`get_youtube_channel`)

Retrieve a YouTube channel profile including description, subscriber count, total views, video count, and creation date.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | YouTube handle (e.g. @mkbhd) |

**Returns:** YouTube channel with description, subscriber count, total views, video count, and join date

**Examples:**

*Look up a YouTube channel:*

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

### Get Twitter Profile (`get_twitter_profile`)

Retrieve a Twitter/X user profile including bio, follower count, following count, tweet count, and verified status.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Twitter/X username or handle |

**Returns:** Twitter profile with bio, follower count, following count, tweet count, and verification status

**Examples:**

*Look up a Twitter account:*

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

### Get LinkedIn Profile (`get_linkedin_profile`)

Retrieve a LinkedIn personal profile including headline, summary, experience, education, and connection count.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full LinkedIn profile URL |

**Returns:** LinkedIn profile with headline, summary, experience, education, skills, and connection count

**Examples:**

*Look up a LinkedIn profile:*

```json
{
  "url": "https://www.linkedin.com/in/satyanadella/"
}
```

### Get LinkedIn Company (`get_linkedin_company`)

Retrieve a LinkedIn company page including description, industry, employee count, headquarters, and specialties.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full LinkedIn company profile URL |

**Returns:** LinkedIn company with description, industry, employee count, headquarters, and founded year

**Examples:**

*Look up a LinkedIn company page:*

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

### Get Facebook Profile (`get_facebook_profile`)

Retrieve a Facebook profile or page including name, bio, follower count, likes, and category information.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full Facebook profile URL |

**Returns:** Facebook profile with name, bio, follower count, page likes, and category

**Examples:**

*Look up a Facebook page:*

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

### Get Reddit Subreddit (`get_reddit_subreddit`)

Retrieve subreddit information including description, member count, active users, creation date, and rules.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `subreddit` | string | Yes | Subreddit name without the r/ prefix (e.g. "programming") |

**Returns:** Subreddit info with description, member count, active users, creation date, and community rules

**Examples:**

*Look up a subreddit:*

```json
{
  "subreddit": "programming"
}
```

### Get Threads Profile (`get_threads_profile`)

Retrieve a Threads user profile including bio, follower count, following count, and verified status.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Threads username or handle |

**Returns:** Threads profile with bio, follower count, following count, and verification status

**Examples:**

*Look up a Threads account:*

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

### Get Bluesky Profile (`get_bluesky_profile`)

Retrieve a Bluesky user profile including display name, bio, follower count, following count, and post count.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Bluesky username or handle |

**Returns:** Bluesky profile with display name, bio, follower count, following count, and post count

**Examples:**

*Look up a Bluesky account:*

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

### Get Truth Social Profile (`get_truthsocial_profile`)

Retrieve a Truth Social user profile including display name, bio, follower count, following count, and post count.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Truth Social username or handle |

**Returns:** Truth Social profile with display name, bio, follower count, following count, and post count

**Examples:**

*Look up a Truth Social account:*

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

### Get Snapchat Profile (`get_snapchat_profile`)

Retrieve a Snapchat user profile including display name, bitmoji, subscriber count, and snap score information.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Snapchat username or handle |

**Returns:** Snapchat profile with display name, bitmoji, subscriber count, and snap score

**Examples:**

*Look up a Snapchat account:*

```json
{
  "handle": "djkhaled305"
}
```

### Get Twitch Profile (`get_twitch_profile`)

Retrieve a Twitch streamer profile including bio, follower count, total views, broadcaster type, and creation date.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Twitch username or handle |

**Returns:** Twitch profile with bio, follower count, total views, broadcaster type, and account creation date

**Examples:**

*Look up a Twitch streamer:*

```json
{
  "handle": "ninja"
}
```

### Get TikTok Followers (`get_tiktok_followers`)

Retrieve the list of followers for a TikTok user, including their usernames, display names, and profile details.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | TikTok username or handle |

**Returns:** List of TikTok followers with usernames, display names, and profile details

**Examples:**

*Get followers of a TikTok creator:*

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

### Get TikTok Following (`get_tiktok_following`)

Retrieve the list of accounts a TikTok user is following, including their usernames, display names, and profile details.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | TikTok username or handle |

**Returns:** List of TikTok accounts the user follows with usernames, display names, and profile details

**Examples:**

*Get accounts a TikTok creator follows:*

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

### Get TikTok Audience Demographics (`get_tiktok_audience`)

Get audience demographic data for a TikTok user. Currently returns audience breakdown by country. Costs 26 credits.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | TikTok username or handle |

**Returns:** Audience location breakdown with country names, codes, counts, and percentages

**Examples:**

*Get audience demographics for a TikTok creator:*

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

### Get Reddit Subreddit Details (`get_reddit_subreddit_details`)

Get detailed information about a subreddit including description, rules, moderators, and community settings. Pass a subreddit name or URL.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `subreddit` | string | No | Subreddit name without r/ prefix |
| `url` | string | No | Full subreddit URL (alternative to name) |

**Returns:** Detailed subreddit info with description, rules, moderators, and community settings

**Examples:**

*Get details about a subreddit:*

```json
{
  "subreddit": "programming"
}
```

### Detect Creator Age and Gender (`detect_age_gender`)

Estimate the age and gender of a social media creator using AI analysis of their profile photo. The profile photo must clearly show a face.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | URL of the profile image or social media profile page |

**Returns:** Estimated age range and gender of the creator based on their profile photo

**Examples:**

*Estimate age and gender from a profile:*

```json
{
  "url": "https://www.tiktok.com/@creator"
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call social-profiles get_tiktok_profile --handle charlidamelio

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

## Frequently Asked Questions

### Do I need a handle or a full URL?

Most platforms use a handle, including TikTok, Instagram, YouTube, X, Threads, Bluesky, Snapchat, Twitch, and Truth Social. LinkedIn and Facebook use full profile or company URLs, and Reddit uses the subreddit name.

### Which platforms give me follower and bio data?

The profile lookups return follower counts, bios, and verification details across the supported platforms, which makes it easy to vet creators, brands, and communities at a glance.

### Can I look at TikTok audience or network data?

Yes. The TikTok profile family includes audience breakdowns plus follower and following lookups, so you can map who a creator reaches and how their network connects.

### Can I estimate demographics from a profile photo?

Yes. The tool includes a photo-based age and gender estimate for cases where you need a rough audience signal from an avatar or headshot.

---

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