1. Brand Sentiment Tracking
Overview
Track how favorability discourse changes over time using a Smart Category. This workflow helps you understand nuanced sentiment shifts tailored to your brand.Prerequisites
- A workspace configured with a “Favorability” Smart Category
Step-by-Step Guide
- Discover Smart Category Configuration Query the filters endpoint to find your Smart Category enrichment_id and available classifications.
- Get Current Favorability Breakdown Use the distribution endpoint to see the current favorability mix across all classifications.
-
Track Favorability Over Time
Use timeline analytics with
group_byset to the Smart Category enrichment_id to see how all favorability classifications evolve over time in a single request.
Example Requests
Step 1: Find Smart Category Enrichment ID
Step 2: Get Current Distribution
Step 3: Track Favorability Over Time
Analysis Tips
- Use the
groupsarray in each timeline bucket to see the breakdown of all favorability classifications for that day - Compare favorability classification counts across time buckets to identify shifts (e.g., increasing “Favorable” counts)
- Calculate percentages within each bucket:
(classification_count / bucket_count) * 100to see daily favorability mix - Track “Favorable” (c0) to see overall positive sentiment trends
- Monitor “Unfavorable” (c1) separately to identify critical reputation issues
- Use the timeline data to correlate favorability changes with specific events or campaigns
2. Bot Detection Analysis
Overview
Assess how much bots are driving the conversation and identify what narratives bots are pushing. This workflow helps you understand the authenticity of discourse and detect coordinated inauthentic behavior.Prerequisites
- A workspace that includes social media channels
Step-by-Step Guide
- Assess Overall Bot Presence Get distribution by bot ratings to see the overall bot landscape.
- Identify High-Confidence Bots Filter to high-confidence bot ratings to focus on likely automated accounts.
- Analyze Bot-Driven Mentions Retrieve mentions from high-confidence bots to understand their messaging.
- Identify Bot Narratives Examine which narratives bots are amplifying by filtering mentions by narrative IDs.
Example Requests
Step 1: Get Bot Rating Distribution
Step 2: Get High-Confidence Bot Mentions
Step 3: Analyze Bot Narratives
Analysis Tips
- High bot percentages (especially “Almost Certain” and “Very Likely”) may indicate coordinated campaigns
- Compare bot-driven narratives with overall narratives to identify amplification patterns
- Track bot activity over time to detect bot network activation
- Cross-reference bot mentions with specific authors to identify bot accounts
3. Channel Distribution Analysis
Overview
Understand channel mix and track how narratives spread from social platforms to mainstream news. This workflow helps you identify cross-channel narrative propagation and understand where conversations originate and amplify.Prerequisites
- A workspace with multiple channels enabled (news and social media)
Step-by-Step Guide
- Get Overall Channel Distribution See the current breakdown of mentions across all channels.
- Track Channel Volume Over Time Use timeline analytics with channel grouping to see volume trends per channel.
- Identify Cross-Channel Spread Analyze timeline data to identify when narratives jump from social to news.
- Track Specific Narrative Channel Progression Optionally filter to a specific narrative to see its channel journey.
Example Requests
Step 1: Get Channel Distribution
Step 2: Track Volume Over Time by Channel
Step 3: Track Specific Narrative Across Channels
Analysis Tips
- Look for days where news volume spikes after social media activity (indicating narrative spread)
- Compare channel percentages over time to see which channels are driving conversation
- Identify “tipping points” when narratives move from niche platforms to mainstream
- Use the groups array in timeline buckets to see daily channel breakdowns
4. Counter-Messaging Effectiveness
Overview
Measure favorability changes before and after making a public statement to assess the impact of your messaging. This workflow helps you quantify how counter-messaging efforts affect brand perception.Prerequisites
- A workspace with a “Favorability” Smart Category configured
- Knowledge of when your public statement was made
Step-by-Step Guide
- Get Pre-Statement Favorability Query distribution for the period before your statement (e.g., 7 days prior).
- Get Post-Statement Favorability Query distribution for the period after your statement (e.g., 7 days after).
- Compare Percentages Calculate the difference in favorability classifications to measure impact.
Example Requests
Step 1: Get Pre-Statement Distribution
Step 2: Get Post-Statement Distribution
Analysis Tips
- Compare percentage changes: “Favorable” increased from 30% to 40% (+10 points)
- Monitor “Unfavorable” decreases to measure reputation recovery
- Track “Neutral” and “Not Applicable” to understand overall sentiment distribution
- Consider volume changes alongside percentage shifts (more mentions with better sentiment is ideal)
- Use longer time windows (14-30 days) for more stable comparisons
5. Velocity Tracking
Overview
Track the rate at which discourse is increasing or decreasing for a specific theme from a Smart Category. This workflow helps you identify accelerating or decelerating conversations and detect emerging trends early.Prerequisites
- A workspace with Smart Categories configured for the theme you want to track
Step-by-Step Guide
- Identify Smart Category Enrichment ID Query filters to find the enrichment_id for your theme’s Smart Category.
- Get Timeline Filtered by Theme Retrieve timeline analytics filtered to a specific Smart Category classification.
- Calculate Velocity Analyze day-over-day volume changes to identify acceleration or deceleration.
- Identify Trend Changes Look for inflection points where velocity shifts significantly.
Example Requests
Step 1: Find Theme Smart Category
Step 2: Get Timeline for Theme
Analysis Tips
- Calculate day-over-day growth rate:
(today - yesterday) / yesterday * 100 - Look for consistent acceleration (increasing growth rates) indicating viral trends
- Identify deceleration points where growth slows, potentially signaling peak interest
- Compare velocity across different Smart Category classifications to see which themes are trending
- Use 7-day moving averages to smooth out daily volatility and identify true trends
6. Threat Monitoring
Overview
Filter high-threat narratives and get analytics to identify and prioritize narratives requiring immediate attention. This workflow helps security and risk teams monitor and respond to emerging threats.Prerequisites
- A workspace with narrative threat scoring enabled
Step-by-Step Guide
-
Get High-Threat Narratives
Filter narratives by
threatLevel=highand sort bythreatScoredescending. - Analyze Threat Volume Over Time Get timeline analytics for specific high-threat narratives to see volume trends.
- Identify Threat Sources Get distribution by channels and authors for threat narratives to understand who’s driving them.
- Get Threat Mentions Retrieve actual mentions from high-threat narratives for detailed analysis.
Example Requests
Step 1: Get High-Threat Narratives
Step 2: Get Timeline for High-Threat Narrative
Step 3: Get Channel Distribution for Threats
Step 4: Get Threat Mentions
Analysis Tips
- Prioritize narratives with both high
threatScore(8-10) and highrelevancyScore(>80) - Monitor volume acceleration in threat narratives as an early warning signal
- Identify which channels and authors are amplifying threats
- Track threatScore trends over time to see if threats are escalating
- Combine threat monitoring with bot detection to identify coordinated threat campaigns
7. Narrative Origin Assessment
Overview
Understand when and how a narrative emerged by analyzing volume over time and examining mentions from the narrative’s early days. This workflow helps you identify key messaging, actors, and channels that drove narrative emergence.Prerequisites
- A workspace with narratives enabled
- A specific narrative ID to analyze
Step-by-Step Guide
- Get Narrative Volume Timeline Retrieve timeline analytics filtered by the narrative ID to identify when it emerged.
- Identify Early Days Find the date range when narrative volume started increasing significantly.
- Get Early Mentions Retrieve mentions from those early days filtered by the narrative ID.
- Analyze Origin Characteristics Examine authors, domains, channels, and content from early mentions.
- Sort Chronologically Sort mentions by published date to see the narrative’s chronological emergence.
Example Requests
Step 1: Get Narrative Timeline
Step 2: Get Early Mentions
Step 3: Get Author Distribution for Early Days
Analysis Tips
- Identify the “patient zero” mention - the first mention with high reach that likely sparked the narrative
- Look for cross-channel amplification: social media mentions followed by news coverage
- Analyze author reach to identify key amplifiers who drove narrative spread
- Compare early messaging with later messaging to see how the narrative evolved
- Track domain distribution to see which publishers picked up the narrative first
- Use chronological sorting to understand the narrative’s progression path
8. Alerting on New Threatening Narratives
Overview
Poll for newly emerged high-threat narratives and trigger alerts when threats are detected. This workflow enables security and risk teams to build automated alerting pipelines that surface new threatening narratives as they emerge.Prerequisites
- A workspace with narrative threat scoring enabled
- A scheduled job or cron that runs at your desired alert frequency (e.g., hourly, daily)
Step-by-Step Guide
-
Poll for High-Threat Narratives
Query narratives with
threatLevel=highand a recent date range (since/to). -
Sort by Creation Date
Sort by
createddescending to surface the newest narratives first. - Identify New Narratives Compare returned narrative IDs against a stored set of previously seen IDs to detect truly new threats (not yet alerted on).
- Fetch Details for Alerts For each new threat, optionally retrieve mentions or timeline data to include in the alert payload.
- Update Seen Narrative IDs Persist the narrative IDs you’ve alerted on so subsequent runs don’t re-alert.
Example Requests
Step 1: Poll for Recent High-Threat Narratives
Step 2: Get Mentions for New Threat (Alert Payload)
Step 3: Get Timeline for Context
Analysis Tips
- Use a narrow
since/towindow (e.g., last hour) for frequent polling to catch new threats quickly - Store narrative IDs in a database or cache to deduplicate alerts across runs
- Consider filtering by
threatScorethreshold (e.g., only alert when >= 8) by filtering the response client-side - Include narrative title, threatScore, mentionCount, and sample mentions in alert notifications for context
- Integrate with Slack, PagerDuty, or email to deliver alerts to the right teams
