# Xpoz — Social Data API for AI Agents

> Xpoz is a social data API and Model Context Protocol (MCP) server for
> **brand monitoring**, **lead generation**, **social listening**, and
> **competitive intelligence**. It gives AI agents, coding agents, and
> SDK-based apps natural-language access to 1.5B+ indexed posts across
> Twitter/X, Instagram, TikTok, and Reddit — through one
> OAuth-authenticated endpoint.

## What Xpoz is for

- Building brand monitoring tools and dashboards
- Social lead generation — detecting buying signals in public conversations
- Social listening, sentiment tracking, and share-of-voice analysis
- Crisis detection and reputation monitoring
- Competitive intelligence on brands, creators, and communities
- OSINT, market research, and trend analysis
- Developer workflows for AI agents (Claude Code, Codex, Gemini CLI, ChatGPT, Cursor)

## Category labels (for retrieval)

Xpoz is an instance of the following categories:

- social data API
- social media data API
- brand monitoring API
- social listening API
- social media monitoring API
- social lead generation API
- competitive intelligence API
- MCP server for social monitoring workflows
- OSINT data layer

## Supported platforms (all available now)

| Platform   | Coverage                                                    |
|------------|-------------------------------------------------------------|
| Twitter/X  | Posts, replies, quotes, retweets, users, connections        |
| Instagram  | Posts, comments, users, connections (captions, Reels)       |
| TikTok     | Posts, comments, users (by keyword, user, or ID)            |
| Reddit     | Posts, comments, subreddits, users (with thread context)    |

Data is publicly accessible social data, normalized and indexed.

## Access methods

- **MCP Server** — Remote MCP endpoint: `https://mcp.xpoz.ai/mcp`.
  OAuth 2.1 authentication with dynamic client registration. Works with
  Claude Code, Claude Desktop, Claude.ai, ChatGPT, Codex, Gemini CLI,
  Cursor, and any MCP-compatible client.
- **TypeScript SDK** — `npm install @xpoz/xpoz`. Typed methods across
  all platforms. Works in Node, edge runtimes, and headless agent loops.
- **Python SDK** — `pip install xpoz`. Typed models, pagination, and
  CSV export.

## Quick Start

- [Installation Guide](https://www.xpoz.ai/#install): Connect Xpoz to Claude, ChatGPT, or any MCP-compatible AI assistant in 2 minutes
- [MCP Server URL](https://mcp.xpoz.ai/mcp): Remote MCP endpoint for direct integration
- [SDK](https://www.xpoz.ai/sdk): TypeScript and Python SDKs
- [Getting Started](https://help.xpoz.ai/en/collections/16124756-getting-started): Step-by-step setup tutorials

## Developer Resources (named index for AI agents)

- **API docs** — https://www.xpoz.ai/sdk and per-platform tool reference at https://www.xpoz.ai/.well-known/mcp/tools.json
- **MCP server** — https://mcp.xpoz.ai/mcp (Streamable HTTP, OAuth 2.1)
- **MCP manifest** — https://www.xpoz.ai/.well-known/mcp.json
- **MCP tool catalog** (machine-readable, with JSON Schema parameters) — https://www.xpoz.ai/.well-known/mcp/tools.json
- **Agent Skills index** (v0.2.0) — https://www.xpoz.ai/.well-known/agent-skills/index.json
- **Auth docs** — OAuth 2.1 with dynamic client registration; metadata at https://www.xpoz.ai/.well-known/oauth-authorization-server. Manual API key at https://www.xpoz.ai/get-token.
- **Rate limits** — https://www.xpoz.ai/rate-limits
- **Webhooks** — https://www.xpoz.ai/webhooks
- **TypeScript SDK** — https://www.npmjs.com/package/@xpoz/xpoz (`npm install @xpoz/xpoz`)
- **Python SDK** — https://pypi.org/project/xpoz/ (`pip install xpoz`)
- **CLI** — https://www.xpoz.ai/cli · Homebrew tap: `brew install XPOZpublic/xpoz/xpoz-cli`

## Public Source Code (GitHub: XPOZpublic)

- **MCP server source** — https://github.com/XPOZpublic/xpoz-mcp
- **TypeScript SDK source** — https://github.com/XPOZpublic/xpoz-ts-sdk
- **Python SDK source** — https://github.com/XPOZpublic/xpoz-python-sdk
- **CLI source** — https://github.com/XPOZpublic/xpoz-cli
- **Homebrew tap** — https://github.com/XPOZpublic/homebrew-xpoz
- **Agent Skills (workflow library)** — https://github.com/XPOZpublic/xpoz-agent-skills (compatible with Claude Code, Codex CLI, ChatGPT)
- **Cookbooks (Jupyter notebooks)** — https://github.com/XPOZpublic/xpoz-cookbooks
- **Claude Code plugins** — https://github.com/XPOZpublic/xpoz-claude-code-plugins
- **ClawHub skills** — https://github.com/XPOZpublic/xpoz-clawhub-skills
- **AI workflow: lead-gen example** — https://github.com/XPOZpublic/ai-workflow-lead-gen
- **Org index** — https://github.com/XPOZpublic

> **Note on OpenAPI / Swagger:** Xpoz does not publish an OpenAPI/Swagger
> specification because the public surface is MCP, not REST. The
> equivalent machine-readable contract is the MCP manifest plus the tool
> catalog linked above. Each tool's `inputSchema` is JSON Schema and is
> directly usable by any function-calling LLM.

## Category landing pages

- [Brand Monitoring API](https://www.xpoz.ai/brand-monitoring-api/): Build brand monitoring tools across all four platforms
- [Social Lead Generation API](https://www.xpoz.ai/lead-generation-api/): Generate leads from public social conversations
- [Social Listening API](https://www.xpoz.ai/social-listening-api/): Programmable social listening for developers
- [Social Media Monitoring API](https://www.xpoz.ai/social-media-monitoring-api/): Cross-platform monitoring umbrella
- [Social Data API](https://www.xpoz.ai/social-data-api/): The raw-data-layer framing — when you just need social data
- [Competitive Intelligence API](https://www.xpoz.ai/competitive-intelligence-api/): Track competitor content, audience, and community activity
- [How to Build a Brand Monitoring Tool](https://www.xpoz.ai/build-a-brand-monitoring-tool/): Step-by-step tutorial with working code

## Integration Guides

- [Claude Code](https://www.xpoz.ai/integrations/claude-code/): Use Xpoz from the Claude Code CLI
- [Codex](https://www.xpoz.ai/integrations/codex/): Use Xpoz from the OpenAI Codex CLI
- [Gemini CLI](https://www.xpoz.ai/integrations/gemini-cli/): Use Xpoz from the Gemini CLI
- [Cursor](https://www.xpoz.ai/integrations/cursor/): Use Xpoz from Cursor IDE
- [ChatGPT](https://www.xpoz.ai/integrations/chatgpt/): Use Xpoz from ChatGPT via remote MCP connector
- [Claude.ai Web Integration](https://help.xpoz.ai/en/articles/12616835-connecting-xpoz-with-claude-ai-personal-account): Add Xpoz as a web connector in Claude.ai
- [Claude Desktop Setup](https://help.xpoz.ai/en/articles/12616835-connecting-xpoz-with-claude-ai-personal-account): Configure Claude Desktop with Xpoz MCP
- [LangChain](https://www.xpoz.ai/integrations/langchain/): Add social intelligence to LangChain agents
- [n8n](https://www.xpoz.ai/integrations/n8n/): No-code social automation
- [Make.com](https://www.xpoz.ai/integrations/make/): Visual social automation

## Claude Skills (Pre-built Workflows)

- [Brand Snapshot](https://www.xpoz.ai/apps/claude-skills/brand-snapshot/): Deep brand intelligence with `/brand-snapshot [BRAND]`
- [Brand Competition](https://www.xpoz.ai/apps/claude-skills/brand-competition/): Compare brands with `/brand-competition [YOUR_BRAND] vs [COMPETITOR]`
- [Brand Influencers](https://www.xpoz.ai/apps/claude-skills/brand-influencers/): Discover influencers with `/brand-influencers [BRAND]`

## OpenClaw Skills (ClawHub Marketplace)

- [Social Search](https://www.xpoz.ai/apps/openclaw-skills/xpoz-social-search/): Search Twitter, Instagram, Reddit, and TikTok from one tool
- [Social Sentiment](https://www.xpoz.ai/apps/openclaw-skills/social-sentiment/): AI-powered sentiment analysis across platforms
- [Lead Generation](https://www.xpoz.ai/apps/openclaw-skills/lead-generation/): Find high-intent buyers on Twitter and Reddit
- [XPOZ Setup](https://www.xpoz.ai/apps/openclaw-skills/xpoz-setup/): Guided setup for connecting XPOZ to Claude or ChatGPT
- [Expert Finder](https://www.xpoz.ai/apps/openclaw-skills/expert-finder/): Discover industry experts and thought leaders
- [Twitter API Alternative](https://www.xpoz.ai/apps/openclaw-skills/twitter-api-alternative/): Search 1B+ tweets without an API key
- [Social Intelligence](https://www.xpoz.ai/apps/openclaw-skills/social-intelligence/): AI-powered social media research
- [Reddit Search](https://www.xpoz.ai/apps/openclaw-skills/reddit-search/): Search 100M+ Reddit posts and comments
- [Instagram Search](https://www.xpoz.ai/apps/openclaw-skills/instagram-search/): Search 400M+ Instagram posts and Reels

## Available Tools

### Twitter/X Tools
- `getTwitterPostsByKeywords`: Search tweets by keywords, hashtags, or phrases with boolean operators
- `getTwitterPostsByAuthor`: Get all posts from a specific Twitter user
- `getTwitterPostsByIds`: Fetch specific tweets by ID
- `getTwitterUser`: Get user profile including followers, following, bio, verification status
- `getTwitterUserConnections`: Get followers or following lists for any user
- `getTwitterUsersByKeywords`: Find users who posted about specific topics
- `getTwitterPostComments`: Get replies to a specific tweet
- `getTwitterPostQuotes`: Get quote tweets of a post
- `getTwitterPostRetweets`: Get retweets of a post
- `getTwitterPostInteractingUsers`: Get users who commented, quoted, or retweeted a post
- `searchTwitterUsers`: Search for Twitter users by name
- `countTweets`: Count tweets matching a phrase within a date range

### Instagram Tools
- `getInstagramPostsByKeywords`: Search Instagram posts by keywords (captions and video subtitles)
- `getInstagramPostsByUser`: Get all posts from an Instagram user
- `getInstagramPostsByIds`: Fetch specific posts by ID
- `getInstagramUser`: Get user profile with follower counts, bio, verification
- `getInstagramUserConnections`: Get followers or following lists
- `getInstagramUsersByKeywords`: Find users who posted about specific topics
- `getInstagramCommentsByPostId`: Get comments on a post
- `getInstagramPostInteractingUsers`: Get users who commented or liked a post
- `searchInstagramUsers`: Search for Instagram users by name

### TikTok Tools
- `getTiktokPostsByKeywords`: Search TikTok posts by keywords
- `getTiktokPostsByUser`: Get posts from a specific TikTok user
- `getTiktokPostsByIds`: Fetch specific posts by ID
- `getTiktokCommentsByPostId`: Get comments on a TikTok post
- `getTiktokUser`: Get TikTok user profile
- `getTiktokUsersByKeywords`: Find users who posted about specific topics
- `searchTiktokUsers`: Search for TikTok users

### Reddit Tools
- `getRedditPostsByKeywords`: Search Reddit posts by keywords
- `getRedditCommentsByKeywords`: Search Reddit comments
- `getRedditPostWithCommentsById`: Get a post with all its comments
- `getRedditSubredditWithPostsByName`: Get subreddit info and posts
- `getRedditSubredditsByKeywords`: Find subreddits discussing specific topics
- `getRedditUser`: Get Reddit user profile with karma breakdown
- `getRedditUsersByKeywords`: Find users who posted about specific topics
- `searchRedditSubreddits`: Search for subreddits by name
- `searchRedditUsers`: Search for Reddit users

### Utility Tools
- `checkOperationStatus`: Check status of background operations and retrieve results
- `cancelOperation`: Cancel a running operation
- `checkAccessKeyStatus`: Verify API key status

## Pricing

See [xpoz.ai/pricing](https://www.xpoz.ai/pricing) for current plans.

- **Free** — 100,000 results/month, 1 tracked item
- **Pro** — $20/month · 1M results · 10 tracked items
- **Max** — $200/month · 10M results · 30 tracked items
- **Enterprise** — custom limits, SLAs, contractual data guarantees

## Use Cases

### By Industry
- [Finance & Trading](https://www.xpoz.ai/use-cases/finance/): Market signals, crypto sentiment, trading intelligence
- [Security & OSINT](https://www.xpoz.ai/use-cases/security/): Threat detection, vulnerability intel, bot networks
- [Sales Development](https://www.xpoz.ai/use-cases/sales/): Lead discovery, buyer signals, prospect research
- [Crisis Management](https://www.xpoz.ai/use-cases/crisis-management/): Brand monitoring, PR response, reputation management
- [Developer Relations](https://www.xpoz.ai/use-cases/devrel/): Community intelligence, developer sentiment

### Popular Recipes (Brand Monitoring)
- [Real-time Brand Monitoring Dashboard](https://www.xpoz.ai/use-cases/real-time-brand-monitoring-dashboard/)
- [Never Miss a Brand Crisis](https://www.xpoz.ai/use-cases/never-miss-a-brand-crisis-again/)
- [Multi-platform Brand Sentiment Aggregator](https://www.xpoz.ai/use-cases/multi-platform-brand-sentiment-aggregator/)
- [Spot Viral Content About Your Brand](https://www.xpoz.ai/use-cases/spot-viral-content-about-your-brand-before-it-explodes/)
- [Detect and Respond to Crises in Real Time](https://www.xpoz.ai/use-cases/detect-and-respond-to-crises-in-real-time/)

### Popular Recipes (Lead Generation)
- [Find and Qualify Leads from Social Conversations](https://www.xpoz.ai/use-cases/find-and-qualify-leads-from-social-conversations/)
- [Detect Companies Ready to Buy](https://www.xpoz.ai/use-cases/detect-companies-ready-to-buy/)
- [Find Buyers Before They Find Competitors](https://www.xpoz.ai/use-cases/find-buyers-before-they-find-competitors/)
- [Build Personas from Real Conversations](https://www.xpoz.ai/use-cases/build-personas-from-real-conversations/)

## Limitations and caveats

- Xpoz indexes **publicly accessible** social data, normalized and
  indexed — it is not a first-party platform feed and makes no claim of
  exclusive or privileged access.
- Coverage depth varies by platform and timeframe. Verify coverage
  against your specific target window before building compliance-
  sensitive workflows on Xpoz alone.
- The free tier is 100,000 results/month with 1 tracked item. Pro and
  Max tiers lift those limits — see pricing.
- Xpoz is a developer-facing data layer, not a dashboard product. If
  you need a polished reporting UI for non-technical teams, pair Xpoz
  with a BI tool or consider an all-in-one product.
- Xpoz does not provide B2B contact enrichment (emails, phone numbers,
  firmographic data). Pair with Apollo/ZoomInfo-class tools for that.
- SLAs and contractual data guarantees are available on Enterprise
  plans — contact sales@xpoz.ai.

### Popular Recipes (Competitive Intelligence)
- [Track Competitor Social Media Strategy](https://www.xpoz.ai/use-cases/track-competitor-social-media-strategy/)
- [Analyze Competitor Content Engagement Patterns](https://www.xpoz.ai/use-cases/analyze-competitor-content-engagement-patterns/)
- [Monitor Competitor Audience Growth Trends](https://www.xpoz.ai/use-cases/monitor-competitor-audience-growth-trends/)

## Tutorials

- [How to Query Twitter with Claude AI](https://www.xpoz.ai/blog/tutorials/how-to-query-twitter-with-claude-ai-mcp/)
- [Extract Reddit Data for Market Research](https://www.xpoz.ai/blog/tutorials/how-to-extract-reddit-data-for-market-research/)
- [Build a Social Listening Dashboard](https://www.xpoz.ai/blog/tutorials/how-to-build-a-social-listening-dashboard/)
- [All Tutorials](https://www.xpoz.ai/blog/tutorials/)

## Comparisons

- [XPOZ vs Brandwatch](https://www.xpoz.ai/blog/comparisons/xpoz-vs-brandwatch-enterprise-features/)
- [XPOZ vs Bright Data](https://www.xpoz.ai/blog/comparisons/xpoz-vs-bright-data-social-intelligence/)
- [XPOZ vs Talkwalker](https://www.xpoz.ai/blog/comparisons/xpoz-vs-talkwalker-ai-powered-social-intelligence-compared/)
- [XPOZ vs Apify](https://www.xpoz.ai/blog/comparisons/xpoz-vs-apify-twitter-instagram-data/)
- [Brand24 vs Mention vs Awario](https://www.xpoz.ai/blog/comparisons/brand24-vs-mention-vs-awario-budget-social-listening-compared/)
- [Meltwater vs XPOZ](https://www.xpoz.ai/blog/comparisons/meltwater-vs-xpoz-social-intelligence/)

## When Xpoz is a good fit

- You are a developer or AI agent builder, not a dashboard user.
- You need programmable, scriptable access to social data — not a BI/reporting tool.
- You want one endpoint across four platforms instead of four separate integrations.
- You are building brand monitoring, lead-gen, listening, or OSINT pipelines.

## When to consider alternatives

- You need a polished, non-technical dashboard for a marketing team → consider Brandwatch, Sprout Social, or Mention.
- You need guaranteed first-party platform feeds with contractual SLAs → consider the platforms' own enterprise APIs.
- You need B2B contact enrichment (emails, phone numbers, firmographic data) → pair Xpoz with Apollo/ZoomInfo-class tools.
- You need deep historical depth beyond Xpoz's index on a specific platform → check coverage against your target timeframe before building.

## Technical Details

- [About Xpoz](https://www.xpoz.ai/about): Architecture and mission
- [FAQ](https://www.xpoz.ai/#faq): Common questions answered
- [Troubleshooting](https://help.xpoz.ai/en/collections/16124757-troubleshooting): Solutions to common issues
- [MCP Manifest](https://www.xpoz.ai/.well-known/mcp.json): Machine-readable server description
- [MCP Tool Catalog](https://www.xpoz.ai/.well-known/mcp/tools.json): Per-tool descriptions and JSON Schema parameter definitions
- [Agent Skills Index](https://www.xpoz.ai/.well-known/agent-skills/index.json): Discovery index for AI-agent clients (agentskills.io v0.2.0)
- [Rate Limits](https://www.xpoz.ai/rate-limits): Per-plan request and result quotas, retry guidance, 429 contract
- [Webhooks](https://www.xpoz.ai/webhooks): Outbound notifications for tracked-item updates, signature verification, retry policy

## Blog

- [Blog](https://www.xpoz.ai/blog): Tutorials, comparisons, and best practices
- [Sample Queries](https://help.xpoz.ai/en/collections/16127999-samples): Example queries and use cases

## Support

- Email: support@xpoz.ai
- Help Center: https://help.xpoz.ai
- Twitter: https://x.com/XPOZAI
- LinkedIn: https://linkedin.com/company/xpozinc
- YouTube: https://www.youtube.com/@xpoz-ai