Continuous Tracking

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`
`keyword`	A search term in post content	`"artificial intelligence"`, `"Tesla"`
`user`	A social media account by username	`"elonmusk"`, `"natgeo"`
`subreddit`	A Reddit community (Reddit-only)	`"wallstreetbets"`, `"MachineLearning"`
`hashtag`	A TikTok hashtag (TikTok-only)	`"fyp"`, `"sustainable_fashion"`

Platform compatibility

Type	Twitter/X	Instagram	Reddit	TikTok
`keyword`	Yes	Yes	Yes	Yes
`user`	Yes	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

Brand monitoring across platforms

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.

Reddit community monitoring

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

TypeScript
Python
CLI

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

Getting Started

Guides

Continuous Tracking

What is continuous tracking?

How it works

What can you track?

Platform compatibility

Best practices

Track strategically

Manage your tracked items

Choose the right type

Common workflows

Brand monitoring across platforms

Competitor tracking

Reddit community monitoring

TikTok hashtag campaign

Listing and removing items

Tracking Tools

Social Tracking Skill

Account Details

​What is continuous tracking?

​How it works

​What can you track?

​Platform compatibility

​Best practices

​Track strategically

​Manage your tracked items

​Choose the right type

​Common workflows

​Brand monitoring across platforms

​Competitor tracking

​Reddit community monitoring

​TikTok hashtag campaign

​Listing and removing items

​Related

Tracking Tools

Social Tracking Skill

Account Details

What is continuous tracking?

How it works

What can you track?

Platform compatibility

Best practices

Track strategically

Manage your tracked items

Choose the right type

Common workflows

Brand monitoring across platforms

Competitor tracking

Reddit community monitoring

TikTok hashtag campaign

Listing and removing items

Related