Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)

ai.xpoz/social-insights

Documentation

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.

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:

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

Claude Code, Codex, Gemini CLI

# 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

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.

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:

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

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

For full results, grab your own API key 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

npm install @xpoz/xpoz

Source: XPOZpublic/xpoz-ts-sdk.

Python

pip install xpoz

Source: 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.

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.

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

License

This repository contains configuration and documentation only. The Xpoz MCP server is a hosted service — see Terms of Service.