📊 XavvyNess Social Monitor — Social Media Intelligence + Sentiment

Monitor any social media profile or keyword across Instagram, TikTok, Twitter/X, and LinkedIn. Get AI-powered sentiment scores, trending topics, engagement analysis, competitor insights, and strategic recommendations — not just raw comment dumps.

The #1 complaint about Social Media Sentiment actors is "it only does comments, not strategy." We built the strategic layer on top.

Demo

🎬 Video demo coming soon. Upload social-monitor.mp4 to YouTube, then run python3 scripts/actor-video-gen.py --embed-readmes to embed it here automatically.

---

🚀 What It Does

1. Finds recent posts and engagement data for any social profile or keyword
2. Analyzes sentiment, trending topics, and audience patterns with AI
3. Generates strategic recommendations and growth opportunities

Perfect for: brand monitoring, influencer research, competitor tracking, content strategy, crisis detection

---

📥 Input

Field	Required	Default	Description
profiles	✅	—	Profile URLs or @handles (e.g. @openai or https://instagram.com/openai)
keywords	—	[]	Additional keywords to focus analysis on
platform	—	auto	auto / instagram / tiktok / twitter / linkedin
postLimit	—	20	How many recent posts to analyze (5-100)
depth	—	standard	quick / standard / deep

Example input:

{
  "profiles": ["@anthropic", "https://twitter.com/openai"],
  "keywords": ["Claude", "GPT", "pricing"],
  "platform": "auto",
  "postLimit": 30,
  "depth": "deep"
}

---

📤 Output

Real output from a live run on @openai:

{
  "profile": "openai",
  "handle": "openai",
  "platform": "general",
  "overallSentiment": "Positive",
  "sentimentScore": "0.7",
  "followerCount": "3.2 million",
  "engagementRate": "2-3%",
  "postingFrequency": "Daily",
  "topTopics": ["API Usage", "GPT-5.2", "Codex", "ChatGPT", "Model Optimization"],
  "contentThemes": ["AI Development", "Product Releases", "Customer Support", "Enterprise Solutions"],
  "audienceType": "Developers and Tech Enthusiasts",
  "summary": "OpenAI has a strong social presence with a large and engaged audience. The company focuses on advancing AI technology, releasing new products and features, and providing support to its users. The audience is primarily composed of developers and tech enthusiasts interested in AI development, product releases, and customer support.",
  "recommendations": [
    "Increase engagement by responding to user feedback and concerns",
    "Expand content themes to include more tutorials and guides for new users",
    "Utilize social media platforms to promote new product releases and features"
  ],
  "analyzedAt": "2026-04-08T22:26:44.759Z",
  "agent": "XavvyNess Social Monitor"
}

---

💡 Analysis Depths

Depth	Output	Best For
quick	Sentiment + top 3 topics	Fast pulse check
standard	+ engagement rate + recommendations	Weekly monitoring
deep	+ competitor comparison + crisis signals + 30-day trend	Strategy planning

---

⚙️ Setup — API Keys

Variable	Required	Where to Get
TAVILY_API_KEY	✅ Required	app.tavily.com (free tier: 1,000 searches/month)
GROQ_API_KEY	Recommended (free)	console.groq.com
GOOGLE_API_KEY	Optional fallback	aistudio.google.com

---

❓ FAQ

Q: Does it scrape social platforms directly?
A: No — we use Tavily's live web search to find and analyze public social content. This means no account bans, no platform blocks.

Q: What platforms are supported?
A: Instagram, TikTok, Twitter/X, LinkedIn, and Facebook. Use platform: "auto" to auto-detect from the URL.

Q: How current is the data?
A: Tavily returns results from the last 24-48 hours. For real-time streaming data, schedule runs every few hours.

---

🔗 Use Cases

1. Brand monitoring — Track sentiment around your brand name 24/7
2. Influencer research — Evaluate engagement quality before a partnership
3. Competitor tracking — Monitor what's working for competitors and why
4. Content strategy — Discover which topics and formats drive the most engagement
5. Crisis detection — Catch negative sentiment spikes before they escalate
6. Campaign measurement — Before/after sentiment analysis for marketing campaigns

---

📊 Performance

• ✅ Analysis per profile: ~15-30s
• ✅ Works across all major platforms without account credentials
• ✅ Retry logic with categorized error messages
• ✅ Groq → Gemini fallback
• ✅ Failed runs are not charged — you only pay for successfully analyzed profiles

---

Integration

Via Apify JavaScript client

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('W0vNaaiXZdeicI7gF').call({
  profiles: ['https://www.instagram.com/openai/', '@anthropic'],
  keywords: ['Claude', 'GPT'],
  platform: 'auto',
  depth: 'standard',
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach(profile => {
  console.log(profile.handle);           // @handle
  console.log(profile.overallSentiment); // positive | neutral | negative
  console.log(profile.topTopics);        // trending topics array
  console.log(profile.recommendations);  // strategic action items
});

Via HTTP API

curl -X POST \
  "https://api.apify.com/v2/acts/W0vNaaiXZdeicI7gF/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "profiles": ["https://www.instagram.com/openai/"],
    "depth": "standard"
  }'

Via Make.com / Zapier

Use the Apify module → Run Actor action. Actor ID: W0vNaaiXZdeicI7gF. Map {{overallSentiment}}, {{topTopics}}, and {{recommendations}} from the output into your automation.

---

Built by XavvyNess — AI agent services that do real work.