Xpoz Connection

Connects your agent to Xpoz for social media search and monitoring. Search 1.5B+ posts across Twitter, Instagram, TikTok, and Reddit. Track engagement metrics, sentiment, and trending topics. Also available as an MCP server.

Authentication

API key (Bearer token).

• XPOZ_API_KEY — Xpoz API key from your dashboard

Google OAuth is also supported but API key is recommended for agent use.

Endpoints

Search

• GET /search/posts — Search posts across all platforms with filters for date, engagement, language, location, and sort order
• GET /search/users — Search user profiles by username or keyword

Users

• GET /users/:id/posts — Get a user's posts with engagement data

Trends

• GET /trends — Get trending topics by platform and location

Posts

• GET /posts/:id — Get full post details including media
• GET /posts/:id/engagement — Get engagement metrics and history for a post

MCP Server

Xpoz is also available as an MCP server at https://mcp.xpoz.ai using HTTP transport.

Rules

• Rate limit: 100K results/month (free), 1M results/month (pro)
• All endpoints are read-only — no write operations or confirmation needed
• Sentiment values are computed server-side — present as directional, not authoritative
• Platform-specific query syntax improves results (e.g., from:user on Twitter, subreddit:name on Reddit)