addTrackedItems

Add keywords/users to track. Accepts array of items with phrase, type (keyword/user/subreddit/hashtag), platform (twitter/instagram/reddit/tiktok). Subreddit is Reddit-only, hashtag is TikTok-only. Returns error if plan limit exceeded.

Medium RISK CLASS
Category Write
Parameters 51 required
Recommended Rate-limitedsee the rule below
Registry record Grade F, identity unverified Pull the record →

This record as markdown: /tools/ai-xpoz-social-insights/addtrackeditems.md

What addTrackedItems does on Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)

AI agents use addTrackedItems to create or update resources in Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ), usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ) environment.

ParameterTypeRequiredDescription
items array Yes Array of items to track. Each item has phrase, type, and platform.
_isTrial boolean
feedback string Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about th
_requestId string
_trialToken string

Parameters from the server's own tool schema.

Why addTrackedItems is rated Medium

An AI agent can call addTrackedItems faster than any human can review: one bad instruction and it creates or modifies resources in Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ) by the hundred, each call as confident as the last.

Questions about addTrackedItems

What does the addTrackedItems tool do? +

Add keywords/users to track. Accepts array of items with phrase, type (keyword/user/subreddit/hashtag), platform (twitter/instagram/reddit/tiktok). Subreddit is Reddit-only, hashtag is TikTok-only. Returns error if plan limit exceeded. It is categorised as a Write tool in the Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ) MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

What parameters does addTrackedItems accept? +

addTrackedItems accepts 5 parameters: items, _isTrial, feedback, _requestId, _trialToken. Required: items. The full parameter table on this page comes from the server's own tool schema.

How do I enforce a policy on addTrackedItems? +

Register the Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ) MCP server in PolicyLayer and add a rule for addTrackedItems: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ). Nothing to install.

What risk level is addTrackedItems? +

addTrackedItems is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.

Can I rate-limit addTrackedItems? +

Yes. Add a rate_limit block to the addTrackedItems rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block addTrackedItems completely? +

Set action: deny in the PolicyLayer policy for addTrackedItems. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides addTrackedItems? +

addTrackedItems is provided by the Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ) MCP server (https://mcp.xpoz.ai/mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

More on Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ), and thousands of servers like it.

Across the catalogue

// THE MCP REGISTRY

PolicyLayer tracks 44,603 MCP servers and 515,000+ tools.

Every server has a live record: who publishes it, whether it answers without auth, its risk grade, every tool classified, the recommended policy. This page is one line of Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)'s. Pull the full record:

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.