xpoz-social-tracking

Social Media Tracking

Overview

Tracking is a best practice for getting more complete data from Xpoz. When you track a keyword, user, subreddit, or hashtag, Xpoz continuously collects data for those items in the background. This means:

• More complete data: Tracked items accumulate data over time, giving you a fuller picture than one-off queries.
• Better coverage: Continuous collection captures posts and activity that a single point-in-time query might miss.

You can track four types of items across platforms:

• Keywords — Track any phrase or topic (e.g., "AI agents", "your brand name"). Xpoz continuously collects posts matching these keywords across the platforms you specify.
• Users — Track specific accounts (e.g., a competitor, influencer, or your own brand handle). Xpoz collects their posts and activity.
• Subreddits (Reddit only) — Track entire subreddit communities to monitor discussions.
• Hashtags (TikTok only) — Track TikTok hashtags to follow trends and campaigns.

When to Use

• "Track mentions of [BRAND] across social media"
• "Set up monitoring for [KEYWORD] on Twitter and Reddit"
• "What keywords am I currently tracking?"
• "Add @competitor to my tracked users on Instagram"
• "Monitor #AIagents on TikTok"
• "Stop tracking [OLD KEYWORD]"
• "How many tracked items can I add?"

Step 1: Check Current Tracking

First, see what's already being tracked.

Via MCP

Call getTrackedItems

Via Python SDK

from xpoz import XpozClient

client = XpozClient()
items = client.tracking.get_tracked_items()
for item in items:
    print(f"[{item.platform}] {item.type}: {item.phrase}")
client.close()

Via TypeScript SDK

import { XpozClient } from "@xpoz/xpoz";

const client = new XpozClient();
await client.connect();
const items = await client.tracking.getTrackedItems();
items.forEach(item => console.log(`[${item.platform}] ${item.type}: ${item.phrase}`));
await client.close();

Via CLI

xpoz-cli tracking get_tracked_items