What is continuous tracking?
Continuous tracking lets you register keywords, users, subreddits, and hashtags that Xpoz monitors on a regular schedule. This results in:
Better coverage — regular monitoring captures more posts and updates, so your search results are more complete
Fresher data — tracked items are kept up to date, so you always get the most recent content
How it works
Add items to track
Use addTrackedItems (MCP tool) or client.tracking.addTrackedItems() (SDK) to register keywords, users, subreddits, or hashtags for continuous tracking.
Xpoz monitors automatically
Xpoz regularly collects new data for your tracked items across all configured platforms.
Results are more complete and up to date
When you search for tracked keywords or query tracked users, you get broader coverage and fresher content.
What can you track?
Every tracked item has three fields: phrase (the term to track), type (what kind of item), and platform (which social network).
Type Description Example phrase keywordA search term in post content "artificial intelligence", "Tesla"userA social media account by username "elonmusk", "natgeo"subredditA Reddit community (Reddit-only) "wallstreetbets", "MachineLearning"hashtagA TikTok hashtag (TikTok-only) "fyp", "sustainable_fashion"
Type Twitter/X Instagram Reddit TikTok keywordYes Yes Yes Yes userYes Yes Yes Yes subreddit— — Yes — hashtag— — — Yes
Best practices
Track strategically
Your plan has a limited number of tracking slots. Focus on high-value terms that you query regularly rather than tracking everything.
Track your brand as a keyword on all four platforms — this is the most common use case
Track competitor accounts as users to monitor their posting activity
Track relevant subreddits where your industry or product is discussed
Track campaign hashtags on TikTok for time-limited campaigns
Manage your tracked items
Call getTrackedItems before removing items — the phrase, type, and platform must match exactly
Use getAccountDetails to check your plan’s tracking limit and current usage
Remove tracked items you no longer need to free up slots for new ones
Choose the right type
Use keyword for topics and phrases — this tracks posts containing those words
Use user for specific accounts — this tracks their posting activity
Use subreddit for Reddit communities — this tracks all posts in that subreddit
Use hashtag for TikTok campaigns — this is more precise than keyword search for hashtag matching
Common workflows
MCP
TypeScript
Python
CLI
Ask your AI agent: Track my brand "Acme Corp" as a keyword on Twitter, Instagram, Reddit, and TikTok.
Also track our official accounts @acmecorp on Twitter and Instagram.
await client . tracking . addTrackedItems ({
items: [
{ phrase: "Acme Corp" , type: "keyword" , platform: "twitter" },
{ phrase: "Acme Corp" , type: "keyword" , platform: "instagram" },
{ phrase: "Acme Corp" , type: "keyword" , platform: "reddit" },
{ phrase: "Acme Corp" , type: "keyword" , platform: "tiktok" },
{ phrase: "acmecorp" , type: "user" , platform: "twitter" },
{ phrase: "acmecorp" , type: "user" , platform: "instagram" },
]
});
client.tracking.add_tracked_items( items = [
{ "phrase" : "Acme Corp" , "type" : "keyword" , "platform" : "twitter" },
{ "phrase" : "Acme Corp" , "type" : "keyword" , "platform" : "instagram" },
{ "phrase" : "Acme Corp" , "type" : "keyword" , "platform" : "reddit" },
{ "phrase" : "Acme Corp" , "type" : "keyword" , "platform" : "tiktok" },
{ "phrase" : "acmecorp" , "type" : "user" , "platform" : "twitter" },
{ "phrase" : "acmecorp" , "type" : "user" , "platform" : "instagram" },
])
xpoz-cli tracking add_tracked_items \
--items '[{"phrase":"Acme Corp","type":"keyword","platform":"twitter"},{"phrase":"Acme Corp","type":"keyword","platform":"instagram"},{"phrase":"Acme Corp","type":"keyword","platform":"reddit"},{"phrase":"Acme Corp","type":"keyword","platform":"tiktok"}]'
Competitor tracking
await client . tracking . addTrackedItems ({
items: [
{ phrase: "CompetitorBrand" , type: "keyword" , platform: "twitter" },
{ phrase: "CompetitorBrand" , type: "keyword" , platform: "reddit" },
{ phrase: "competitor_official" , type: "user" , platform: "twitter" },
{ phrase: "competitor_official" , type: "user" , platform: "instagram" },
]
});
Then periodically search and compare using the Competitive Intelligence skill.
await client . tracking . addTrackedItems ({
items: [
{ phrase: "MachineLearning" , type: "subreddit" , platform: "reddit" },
{ phrase: "artificial" , type: "subreddit" , platform: "reddit" },
{ phrase: "machine learning" , type: "keyword" , platform: "reddit" },
]
});
TikTok hashtag campaign
await client . tracking . addTrackedItems ({
items: [
{ phrase: "myBrandChallenge" , type: "hashtag" , platform: "tiktok" },
{ phrase: "my brand challenge" , type: "keyword" , platform: "tiktok" },
{ phrase: "mybrand" , type: "user" , platform: "tiktok" },
]
});
Track both the hashtag and related keywords. Users don’t always include the hashtag, so keyword tracking captures posts that reference the campaign without tagging it.
Listing and removing items
const tracked = await client . tracking . getTrackedItems ();
console . log ( tracked );
await client . tracking . removeTrackedItems ({
items: [
{ phrase: "old_keyword" , type: "keyword" , platform: "twitter" }
]
});
tracked = client.tracking.get_tracked_items()
print (tracked)
client.tracking.remove_tracked_items( items = [
{ "phrase" : "old_keyword" , "type" : "keyword" , "platform" : "twitter" }
])
xpoz-cli tracking get_tracked_items
xpoz-cli tracking remove_tracked_items \
--items '[{"phrase":"old_keyword","type":"keyword","platform":"twitter"}]'
Tracking Tools MCP tool reference for getTrackedItems, addTrackedItems, removeTrackedItems
Social Tracking Skill Pre-built AI skill for managing tracked items
Account Details Check your plan limits and tracking usage