How to Build a Brand Monitoring Tool

npm install @xpoz/xpoz
# or
pip install xpoz

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

const client = new XpozClient({ apiKey: process.env.XPOZ_API_KEY });
await client.connect();

const brand = "YourBrand";
const [twitter, reddit, instagram] = await Promise.all([
  client.twitter.searchPosts(brand, { limit: 100 }),
  client.reddit.searchPosts(brand, { limit: 100 }),
  client.instagram.searchPosts(brand, { limit: 100 }),
]);

const all = [...twitter.data, ...reddit.data, ...instagram.data];
console.log(`Found ${all.length} mentions across platforms`);

const byId = new Map();
for (const mention of all) {
  if (!byId.has(mention.id)) byId.set(mention.id, mention);
}
const unique = Array.from(byId.values());

const scored = unique.map((m) => ({
  ...m,
  sentiment: quickSentiment(m.text),
}));

function quickSentiment(text) {
  const negatives = ["bad", "broken", "terrible", "hate", "worst", "broken"];
  const lower = text.toLowerCase();
  return negatives.some((w) => lower.includes(w)) ? "negative" : "neutral-or-positive";
}

const alerts = scored.filter((m) => m.sentiment === "negative");
if (alerts.length > 0) {
  await sendSlackAlert(`${alerts.length} negative mentions today`, alerts);
}

async function sendSlackAlert(message, items) {
  await fetch(process.env.SLACK_WEBHOOK_URL, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ text: `${message}\n${items.slice(0, 5).map((i) => `- ${i.text}`).join("\n")}` }),
  });
}