# Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ) [Health: Active]

**Category:** 🌐 Social Media  
**Repository:** https://github.com/xpozpublic/xpoz-mcp  
**GitHub Stars:** 10  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/social-media-search-api-twitter-instagram-reddit-tiktok-xpoz

## Description
Twitter/X, Instagram, Reddit & TikTok data for AI agents. 1.5B+ posts. No API keys.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "social-media-search-api-twitter-instagram-reddit-tiktok-xpoz": {
    "command": "uvx",
    "args": ["xpoz"]
  }
}
```

## Documentation & README

# Xpoz MCP Server

**Search Twitter, Instagram, Reddit & TikTok from any AI agent.** Billions of posts indexed. Natural language queries. CSV exports up to 500K rows. No API keys needed.

[![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed-blue)](https://registry.modelcontextprotocol.io/?q=xpoz)
[![Website](https://img.shields.io/badge/xpoz.ai-visit-green)](https://xpoz.ai)

> **Remote MCP server** — no local installation required. Connect via Streamable HTTP and authenticate with OAuth 2.1 (sign in with Google, no API keys to manage). Direct probes to `https://mcp.xpoz.ai/mcp` return `401 Unauthorized` — that's expected; your MCP client handles the OAuth flow.

## Quick Start

### Claude Desktop / Cursor / Windsurf

Add to your MCP config:

```json
{
  "mcpServers": {
    "xpoz": {
      "type": "streamable-http",
      "url": "https://mcp.xpoz.ai/mcp"
    }
  }
}
```

### Claude Code, Codex, Gemini CLI

```bash
# Claude Code
claude mcp add --transport http --scope user xpoz https://mcp.xpoz.ai/mcp

# Codex / Gemini CLI: see https://www.xpoz.ai/integrations
```

### OpenClaw

```bash
clawhub install xpoz-social-search
```

Then authenticate via the OAuth link when prompted. Eight more pre-built skills are available — see [`clawhub.ai/u/atyachin`](https://clawhub.ai/u/atyachin).

### Try it without signing up

Want to kick the tires first? Mint a free trial token — no sign-in required, valid for 5 days. It returns a limited set of results so you can see the server in action:

```bash
# Get a trial token (starts with "TRIAL")
curl -X POST https://api.xpoz.ai/api/trial/token
# -> { "success": true, "data": { "accessKey": "TRIAL...", "expiresInSeconds": 432000 }, ... }
```

Skip the OAuth flow by passing the trial token as a bearer header in your MCP config:

```json
{
  "mcpServers": {
    "xpoz": {
      "type": "streamable-http",
      "url": "https://mcp.xpoz.ai/mcp",
      "headers": { "Authorization": "Bearer TRIAL..." }
    }
  }
}
```

For full results, [grab your own API key](https://www.xpoz.ai/get-token) or just connect via OAuth as shown above.

---

## SDKs & CLI

If you'd rather call Xpoz directly from code or a terminal instead of through an MCP client:

### TypeScript / Node.js

```bash
npm install @xpoz/xpoz
```

Source: [`XPOZpublic/xpoz-ts-sdk`](https://github.com/XPOZpublic/xpoz-ts-sdk).

### Python

```bash
pip install xpoz
```

Source: [`XPOZpublic/xpoz-python-sdk`](https://github.com/XPOZpublic/xpoz-python-sdk).

### CLI

| Platform | Install command |
|---|---|
| macOS / Linux (Homebrew) | `brew install XPOZpublic/xpoz/xpoz-cli` |
| macOS / Linux (one-liner) | `curl -fsSL https://raw.githubusercontent.com/XPOZpublic/xpoz-cli/main/install.sh \| sh` |
| Windows (PowerShell) | `iwr -useb https://raw.githubusercontent.com/XPOZpublic/xpoz-cli/main/install.ps1 \| iex` |
| Windows (winget) | `winget install Xpoz.XpozCli` |
| Any platform with Python ≥ 3.10 | `pip install xpoz-cli` |

Source: [`XPOZpublic/xpoz-cli`](https://github.com/XPOZpublic/xpoz-cli).

All four channels speak the same MCP protocol against `https://mcp.xpoz.ai/mcp` under the hood, so any tool you see below is reachable from every surface. Get an API token at [`xpoz.ai/get-token`](https://www.xpoz.ai/get-token).

---

## Platforms & Tools

### Twitter / X (14 tools)

| Tool | Description |
|------|-------------|
| `searchTwitterUsers` | Find users by name, bio, or keywords |
| `getTwitterUser` | Get profile details (followers, bio, metrics) |
| `getTwitterUsersByKeywords` | Discover users actively posting about topics |
| `getTwitterUserConnections` | Get followers or following list |
| `getTwitterPostsByKeywords` | Search tweets by keywords, hashtags, mentions |
| `getTwitterPostsByAuthor` | Get tweets from a specific user |
| `getTwitterPostsByIds` | Fetch specific tweets by ID |
| `getTwitterPostComments` | Get replies to a tweet |
| `getTwitterPostRetweets` | Get retweets of a tweet |
| `getTwitterPostQuotes` | Get quote tweets |
| `getTwitterPostInteractingUsers` | Users who liked/retweeted a post |
| `countTweets` | Count tweets matching a query (hourly/daily buckets) |
| `checkOperationStatus` | Poll async export operations |
| `cancelOperation` | Cancel a running operation |

### Instagram (9 tools)

| Tool | Description |
|------|-------------|
| `searchInstagramUsers` | Find users by name or username |
| `getInstagramUser` | Get profile details and metrics |
| `getInstagramUsersByKeywords` | Discover users posting about topics |
| `getInstagramUserConnections` | Get followers or following list |
| `getInstagramPostsByKeywords` | Search posts by keywords or hashtags |
| `getInstagramPostsByUser` | Get posts from a specific user |
| `getInstagramPostsByIds` | Fetch specific posts by ID |
| `getInstagramPostInteractingUsers` | Users who liked/commented on a post |
| `getInstagramCommentsByPostId` | Get comments on a post |

### Reddit (9 tools)

| Tool | Description |
|------|-------------|
| `searchRedditUsers` | Find users by name |
| `getRedditUser` | Get user profile and karma |
| `getRedditUsersByKeywords` | Discover users active in topics |
| `getRedditPostsByKeywords` | Search posts across subreddits |
| `getRedditPostWithCommentsById` | Get a post with its comment tree |
| `getRedditCommentsByKeywords` | Search comments by keywords |
| `searchRedditSubreddits` | Find subreddits by name |
| `getRedditSubredditWithPostsByName` | Get a subreddit's metadata and recent posts |
| `getRedditSubredditsByKeywords` | Discover subreddits by topic |

### TikTok (7 tools)

| Tool | Description |
|------|-------------|
| `searchTiktokUsers` | Find creators by name or username |
| `getTiktokUser` | Get creator profile (followers, likes, bio, verification) |
| `getTiktokUsersByKeywords` | Discover creators by topic in their post history |
| `getTiktokPostsByKeywords` | Search videos by keywords or hashtags |
| `getTiktokPostsByUser` | Get videos posted by a specific creator |
| `getTiktokPostsByIds` | Fetch specific videos by ID |
| `getTiktokCommentsByPostId` | Get comments on a specific video |

### Tracking & Monitoring (3 tools)

For continuous brand monitoring and lead generation — Xpoz indexes new matching content as it appears.

| Tool | Description |
|------|-------------|
| `addTrackedItems` | Subscribe to ongoing monitoring of a query, user, or subreddit across any platform |
| `getTrackedItems` | List your active tracked items with last-update timestamps |
| `removeTrackedItems` | Stop monitoring tracked items by ID |

---

## Key Features

- **Natural language queries** — describe what you want, Xpoz optimizes the search
- **CSV exports** — up to 500K rows in a single download via async operations
- **Server-side pagination** — handle large result sets efficiently
- **Field selection** — request only the fields you need
- **Cache control** — `forceLatest: true` bypasses cache for real-time data
- **Async operations** — long-running exports with status polling
- **OAuth 2.1** — dynamic client registration with Google as the upstream identity provider, no API keys to manage

## Use Cases

- **Lead generation** — find people discussing problems your product solves
- **Influencer discovery** — identify creators by what they post, not just follower count
- **Brand monitoring** — track mentions, sentiment, and competitor activity
- **Market research** — analyze trends and conversations at scale
- **Expert finding** — discover domain authorities across platforms
- **Security intelligence** — monitor vulnerability discussions before CVEs publish

## Discovery surfaces (for AI agents and scanners)

These public, machine-readable endpoints describe Xpoz to crawlers and agentic clients:

| Surface | URL |
|---|---|
| MCP manifest | https://www.xpoz.ai/.well-known/mcp.json |
| MCP tool catalog (descriptions + JSON-Schema parameters) | https://www.xpoz.ai/.well-known/mcp/tools.json |
| Agent Skills index (agentskills.io v0.2.0) | https://www.xpoz.ai/.well-known/agent-skills/index.json |
| `llms.txt` | https://www.xpoz.ai/llms.txt |
| `llms-full.txt` | https://www.xpoz.ai/llms-full.txt |
| `discovery.txt` | https://www.xpoz.ai/discovery.txt |
| Webhooks contract | https://www.xpoz.ai/webhooks |
| Rate limits & 429 contract | https://www.xpoz.ai/rate-limits |

## Links

- 🌐 [xpoz.ai](https://xpoz.ai)
- 💰 [Pricing](https://www.xpoz.ai/pricing)
- 📦 [MCP Registry](https://registry.modelcontextprotocol.io/?q=xpoz)
- 🛠️ [ClawHub Skills](https://clawhub.ai/u/atyachin)
- 📖 [Documentation](https://help.xpoz.ai)
- 🐙 [XPOZpublic on GitHub](https://github.com/XPOZpublic) — TS SDK, Python SDK, CLI, agent skills, cookbooks
- 🍺 [Homebrew tap](https://github.com/XPOZpublic/homebrew-xpoz)

## License

This repository contains configuration and documentation only. The Xpoz MCP server is a hosted service — see [Terms of Service](https://www.xpoz.ai/terms).