In a nutshell: The Rodz API gives you five social signal types to track LinkedIn and social platform activity in real time: social-mentions, social-reactions, influencer-engagement, company-page-engagement, and company-followers. This guide covers what each signal detects, when to use it, how to configure it with cURL, what the webhook payloads look like, and how to combine them into a unified engagement strategy. If you sell to growing companies, these signals will show you who is gaining momentum before the rest of the market notices.
What Are Social Signals?
Social signals are business events derived from public social media activity. They capture patterns in how companies, their leaders, and their audiences interact on platforms like LinkedIn, Twitter/X, and industry forums. Unlike financial signals (funding rounds, M&A) that reflect boardroom decisions, social signals reflect market perception and community engagement. They are leading indicators: a spike in follower growth or a burst of influencer mentions often precedes a funding announcement, a product launch, or a hiring push.
For B2B sales and marketing teams, social signals answer a simple but powerful question: which companies are gaining attention right now? When a company’s LinkedIn page suddenly attracts 40% more followers in a month, when an industry influencer comments on their latest post, or when their CEO is mentioned across multiple threads, something is happening. That “something” is often a buying opportunity.
The Rodz API exposes five distinct social signal types. Each one monitors a different facet of social activity, and each one can be configured independently with its own filters, thresholds, and webhook destinations. Together, they give you a 360-degree view of a company’s social footprint.
This guide assumes you have already set up authentication with the Rodz API. If that is not the case, start with Getting Started: Authentication and Your First Request before continuing here.
Prerequisites
Before configuring social signals, make sure you have the following:
- A Rodz account with API access enabled. API access is included on all paid plans.
- Your API key, generated from the Rodz dashboard under Settings > API Keys. If you need help generating one, follow the authentication guide.
- cURL installed on your machine. macOS and Linux include it by default. Windows users can use Git Bash or WSL.
- A webhook endpoint ready to receive payloads. This can be a custom server, a Zapier webhook, a Make scenario, or any HTTPS URL that accepts POST requests. See our webhook setup guide for details.
- A list of target companies or industries you want to monitor. Social signals work best when scoped to your ICP.
- Basic familiarity with REST APIs and JSON. No SDK is needed.
Set your API key as an environment variable to keep the examples clean throughout this guide:
export RODZ_API_KEY="your_api_key_here"Signal 1: Social Mentions
What It Detects
The social-mentions signal fires when a company or one of its key executives is mentioned on social platforms, forums, news sites, or blog posts. The Rodz platform aggregates mentions across LinkedIn, Twitter/X, Reddit, Hacker News, and major industry publications. Each mention is scored for relevance and sentiment, so you can filter out noise and focus on meaningful conversations.
Mentions can be direct (someone tags the company) or indirect (someone discusses the company by name without tagging). The API captures both and normalizes them into a single stream.
When to Use It
Social mentions are most valuable for three scenarios:
- Timing outreach around buzz. When a company is being talked about positively, your outreach feels relevant rather than random. “I saw the discussion around your new feature on LinkedIn” is a stronger opener than a cold template.
- Monitoring competitors’ customers. Configure mentions for your competitors’ brand names. When someone complains about a competitor publicly, that is a warm lead.
- Tracking market trends. Monitor mentions of specific keywords tied to your product category. Rising mention volume around “data enrichment” or “sales automation” tells you where the market is heading.
cURL Example
curl -X POST https://api.rodz.io/v1/signals/configurations \
-H "Authorization: Bearer $RODZ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Social mentions - SaaS Series A companies",
"type": "social-mentions",
"filters": {
"industries": ["software", "saas"],
"company_size": {"min": 50, "max": 500},
"geography": ["FR", "DE", "GB", "NL", "BE"],
"mention_sources": ["linkedin", "twitter", "reddit"],
"min_mentions": 5,
"time_window_days": 7,
"sentiment": ["positive", "neutral"]
},
"webhook_url": "https://your-server.com/webhooks/social-mentions",
"active": true
}'This configuration triggers when a SaaS company with 50 to 500 employees in Western Europe receives at least 5 mentions across LinkedIn, Twitter, or Reddit within a 7-day window, with positive or neutral sentiment.
Webhook Payload
When the signal fires, Rodz sends a POST request to your webhook URL with a payload like this:
{
"signal_id": "sig_sm_8f2a1b3c",
"type": "social-mentions",
"triggered_at": "2026-03-07T09:15:00Z",
"company": {
"id": "comp_4e7d9a",
"name": "Datawise",
"domain": "datawise.io",
"industry": "saas",
"employee_count": 120,
"country": "FR"
},
"data": {
"mention_count": 8,
"time_window_days": 7,
"sources": {
"linkedin": 5,
"twitter": 2,
"reddit": 1
},
"sentiment_breakdown": {
"positive": 6,
"neutral": 2,
"negative": 0
},
"top_mentions": [
{
"source": "linkedin",
"author": "Marie Dupont",
"text": "Impressive product launch from Datawise this week...",
"url": "https://linkedin.com/posts/...",
"engagement_score": 142,
"published_at": "2026-03-05T14:30:00Z"
}
]
}
}Use Case: Competitor Displacement
A sales team at a CRM company configures social-mentions to monitor mentions of their top three competitors. When the signal detects a negative sentiment spike around a competitor (complaints about downtime, pricing changes, or missing features), the team receives a webhook and routes the lead to a dedicated “displacement” sequence in their outreach tool. The result: outreach that feels timely and empathetic rather than opportunistic.
Signal 2: Social Reactions
What It Detects
The social-reactions signal tracks engagement metrics on content published by a target company or its executives. This includes likes, comments, shares, and reposts on LinkedIn, Twitter/X, and other platforms. Unlike social-mentions, which captures what others say about a company, social-reactions measures how audiences respond to what the company itself publishes.
The signal looks at engagement velocity, not just absolute numbers. A company that normally gets 20 likes per post and suddenly receives 200 is more noteworthy than a large brand that always gets high engagement. Rodz calculates a baseline for each company and fires the signal when engagement deviates significantly from the norm.
When to Use It
- Identifying companies in growth mode. Rising engagement on company content often correlates with increased marketing spend, new product releases, or a successful repositioning. These companies are actively investing in growth and are more receptive to tools that support that momentum.
- Spotting viral content. When a company post goes viral, it creates a conversation window. Your outreach can reference the post directly, making your message instantly relevant.
- Tracking executive thought leadership. Monitoring reactions to posts by C-level executives at target accounts helps you gauge their priorities and communication style before reaching out.
cURL Example
curl -X POST https://api.rodz.io/v1/signals/configurations \
-H "Authorization: Bearer $RODZ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Engagement spikes - Tech companies",
"type": "social-reactions",
"filters": {
"industries": ["software", "fintech", "cybersecurity"],
"company_size": {"min": 20, "max": 1000},
"geography": ["US", "GB", "CA", "AU"],
"platforms": ["linkedin"],
"engagement_multiplier": 3.0,
"min_reactions": 50,
"include_executive_posts": true
},
"webhook_url": "https://your-server.com/webhooks/social-reactions",
"active": true
}'The engagement_multiplier parameter is the key here. A value of 3.0 means the signal triggers only when engagement on a post is at least three times the company’s rolling average. This eliminates noise from companies that consistently post popular content and surfaces only genuine spikes.
Webhook Payload
{
"signal_id": "sig_sr_2c4e8f1a",
"type": "social-reactions",
"triggered_at": "2026-03-07T11:42:00Z",
"company": {
"id": "comp_7b3f2e",
"name": "SecureStack",
"domain": "securestack.com",
"industry": "cybersecurity",
"employee_count": 85,
"country": "US"
},
"data": {
"platform": "linkedin",
"post_url": "https://linkedin.com/posts/securestack-...",
"post_type": "company_update",
"reactions": {
"likes": 312,
"comments": 47,
"shares": 28,
"total": 387
},
"baseline_average": 45,
"engagement_multiplier": 8.6,
"post_author": {
"name": "James Hartley",
"title": "CEO at SecureStack",
"linkedin_url": "https://linkedin.com/in/jameshartley"
},
"post_snippet": "We just shipped end-to-end encryption for...",
"published_at": "2026-03-06T16:00:00Z"
}
}Use Case: Product Launch Detection
A marketing agency monitors social-reactions for 200 mid-market SaaS companies. When SecureStack’s CEO post about a new feature receives 8.6x the normal engagement, it is clear that a product launch is underway. The agency’s SDR reaches out within 24 hours, offering post-launch marketing support. The timing is precise because the signal captured the moment the market started paying attention.
Signal 3: Influencer Engagement
What It Detects
The influencer-engagement signal monitors when recognized industry influencers interact with a company’s content or mention a company in their own posts. Rodz maintains an internal database of influencers categorized by industry, platform, and reach. When an influencer likes, comments on, shares, or tags a company, this signal fires.
The difference between this and social-mentions is specificity. A mention from a random account and a mention from a top-50 industry influencer carry very different weight. This signal isolates the high-impact interactions.
When to Use It
- Identifying rising companies. When multiple influencers start paying attention to a company within a short period, it usually means the company is doing something right. Product-market fit, a strong launch, or an innovative approach, whatever the reason, influencer attention is a reliable indicator of momentum.
- Finding warm introduction paths. If an influencer in your network has engaged with a target company, that is a potential introduction path. The signal gives you the data to make the connection.
- Competitive intelligence. Track influencer engagement with your competitors. If a well-known analyst starts promoting a rival product, you want to know immediately.
cURL Example
curl -X POST https://api.rodz.io/v1/signals/configurations \
-H "Authorization: Bearer $RODZ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Influencer interactions - B2B SaaS",
"type": "influencer-engagement",
"filters": {
"industries": ["software", "saas", "martech"],
"company_size": {"min": 10, "max": 500},
"influencer_categories": ["sales_tech", "marketing_tech", "growth"],
"min_influencer_reach": 10000,
"interaction_types": ["comment", "share", "mention"],
"geography": ["US", "FR", "GB", "DE"]
},
"webhook_url": "https://your-server.com/webhooks/influencer",
"active": true
}'The min_influencer_reach parameter sets a floor for the influencer’s follower count, filtering out micro-influencers if you only want high-reach interactions. The interaction_types parameter lets you prioritize deeper engagement (comments and shares) over passive engagement (likes).
Webhook Payload
{
"signal_id": "sig_ie_9a1b4d2f",
"type": "influencer-engagement",
"triggered_at": "2026-03-07T14:20:00Z",
"company": {
"id": "comp_3c8e1f",
"name": "GrowthLoop",
"domain": "growthloop.co",
"industry": "martech",
"employee_count": 65,
"country": "US"
},
"data": {
"influencer": {
"name": "Elena Varga",
"platform": "linkedin",
"profile_url": "https://linkedin.com/in/elenavarga",
"follower_count": 87000,
"category": "marketing_tech"
},
"interaction_type": "comment",
"interaction_content": "This is exactly the kind of CDP approach the market needs. Most tools overcomplicate the data layer...",
"target_post": {
"url": "https://linkedin.com/posts/growthloop-...",
"author": "GrowthLoop (Company Page)",
"snippet": "We rebuilt our identity resolution engine from scratch...",
"published_at": "2026-03-06T10:00:00Z"
},
"influencer_engagement_history": {
"total_interactions_30d": 3,
"first_interaction_date": "2026-02-18T08:45:00Z"
}
}
}Use Case: Warm Outreach Through Shared Connections
A sales rep at a data integration company sees that Elena Varga, a well-known martech analyst, has commented on GrowthLoop’s post three times in the past month. The rep checks their own LinkedIn network and discovers they share a mutual connection with Elena. Instead of cold-emailing GrowthLoop, the rep asks for an introduction through the shared connection, referencing the specific conversation between Elena and GrowthLoop. The meeting is booked within a week.
Signal 4: Company Page Engagement
What It Detects
The company-page-engagement signal monitors overall engagement trends on a company’s official social media pages. Rather than tracking individual posts or specific influencers, this signal looks at aggregate metrics: total interactions per week, engagement rate changes, content publishing frequency, and audience growth patterns.
It functions like a health check for a company’s social presence. A company that doubles its posting frequency and sees a corresponding engagement increase is likely investing in brand building, which often accompanies a growth phase, a new market entry, or a product launch.
When to Use It
- Spotting companies investing in marketing. An increase in posting cadence combined with rising engagement tells you a company has likely hired a marketing team or engaged an agency. If you sell marketing tools, analytics platforms, or content services, this is a direct indicator of buyer intent.
- Monitoring account health. For existing customers, declining page engagement can be an early churn indicator. If a customer stops investing in their online presence, they may be cutting budgets across the board.
- Benchmarking against peers. Compare page engagement across companies in the same industry to identify who is gaining mindshare.
cURL Example
curl -X POST https://api.rodz.io/v1/signals/configurations \
-H "Authorization: Bearer $RODZ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Page engagement growth - SMBs Europe",
"type": "company-page-engagement",
"filters": {
"industries": ["software", "ecommerce", "consulting"],
"company_size": {"min": 10, "max": 200},
"geography": ["FR", "BE", "NL", "DE", "ES"],
"platforms": ["linkedin"],
"engagement_growth_percent": 30,
"min_posts_per_month": 4,
"time_window_days": 30
},
"webhook_url": "https://your-server.com/webhooks/page-engagement",
"active": true
}'The engagement_growth_percent parameter defines the threshold: only trigger when overall engagement has increased by at least 30% compared to the previous period. The min_posts_per_month filter ensures you are not flagged about companies that posted once and got lucky. You want consistent, growing activity.
Webhook Payload
{
"signal_id": "sig_cpe_5d2a7e9c",
"type": "company-page-engagement",
"triggered_at": "2026-03-07T08:00:00Z",
"company": {
"id": "comp_9f4b2a",
"name": "Flowdesk",
"domain": "flowdesk.eu",
"industry": "software",
"employee_count": 45,
"country": "FR"
},
"data": {
"platform": "linkedin",
"page_url": "https://linkedin.com/company/flowdesk",
"current_period": {
"start": "2026-02-05",
"end": "2026-03-06",
"total_posts": 12,
"total_reactions": 1840,
"total_comments": 156,
"total_shares": 89,
"engagement_rate": 4.2
},
"previous_period": {
"start": "2026-01-05",
"end": "2026-02-04",
"total_posts": 6,
"total_reactions": 720,
"total_comments": 48,
"total_shares": 31,
"engagement_rate": 2.1
},
"growth": {
"posts_change_percent": 100,
"reactions_change_percent": 155.6,
"engagement_rate_change_percent": 100
}
}
}Use Case: Marketing Tool Upsell
A social media management platform monitors company-page-engagement for SMBs in Europe. When Flowdesk doubles its posting frequency and sees a 155% increase in reactions, the platform’s sales team knows Flowdesk is investing in LinkedIn. The outreach message highlights how the platform’s scheduling and analytics features can amplify the results Flowdesk is already achieving. The conversation starts from a position of momentum rather than a cold pitch.
Signal 5: Company Followers
What It Detects
The company-followers signal tracks changes in a company’s follower count on LinkedIn and other social platforms. It measures both absolute growth and growth velocity. A company that gains 500 followers in a week is interesting. A company that normally gains 20 followers per week and suddenly gains 500 is remarkable.
Follower growth is one of the most reliable early indicators of market momentum. It precedes revenue growth, hiring surges, and media coverage. People follow companies they are interested in, whether as potential customers, future employees, or investors. A spike in follower growth means a spike in market attention.
When to Use It
- Detecting pre-funding momentum. Companies preparing for a funding round often increase their social presence to attract investor attention. A sudden follower surge can precede a funding announcement by weeks.
- Identifying employer brand investments. Companies planning a major hiring push often build their employer brand first. Rising followers combined with increased content about culture and team events signal an upcoming recruitment drive.
- Tracking market entrants. New companies in your space that gain followers rapidly are building market presence. Whether they are future competitors or potential partners, you want to know about them early.
cURL Example
curl -X POST https://api.rodz.io/v1/signals/configurations \
-H "Authorization: Bearer $RODZ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Follower growth spikes - Tech startups",
"type": "company-followers",
"filters": {
"industries": ["software", "saas", "fintech", "healthtech"],
"company_size": {"min": 5, "max": 300},
"geography": ["US", "GB", "FR", "DE", "NL"],
"platforms": ["linkedin"],
"growth_rate_percent": 25,
"min_follower_count": 500,
"time_window_days": 14
},
"webhook_url": "https://your-server.com/webhooks/followers",
"active": true
}'The growth_rate_percent sets the minimum follower increase as a percentage of the starting count. Combined with min_follower_count, this prevents false positives from tiny accounts where a handful of new followers would trigger the threshold. A company with 500 followers gaining 25% (125 new followers) in two weeks is genuinely noteworthy.
Webhook Payload
{
"signal_id": "sig_cf_1e8b3d4a",
"type": "company-followers",
"triggered_at": "2026-03-07T06:30:00Z",
"company": {
"id": "comp_2d6c8f",
"name": "Nomad Health",
"domain": "nomadhealth.io",
"industry": "healthtech",
"employee_count": 30,
"country": "US"
},
"data": {
"platform": "linkedin",
"page_url": "https://linkedin.com/company/nomad-health",
"current_followers": 3200,
"previous_followers": 2100,
"new_followers": 1100,
"growth_rate_percent": 52.4,
"time_window_days": 14,
"daily_breakdown": [
{ "date": "2026-02-21", "new_followers": 25 },
{ "date": "2026-02-22", "new_followers": 30 },
{ "date": "2026-02-23", "new_followers": 45 },
{ "date": "2026-02-24", "new_followers": 110 },
{ "date": "2026-02-25", "new_followers": 180 }
],
"estimated_cause": "viral_post"
}
}Use Case: Pre-Funding Outreach
A VC-backed sales intelligence tool monitors company-followers for healthtech startups. When Nomad Health’s followers jump 52% in two weeks, the team investigates and finds the company just published a viral case study. The tool’s SDR reaches out to the CEO, congratulating them on the traction and suggesting a demo of the platform to capitalize on the growing attention. Three weeks later, Nomad Health announces a Series A. The SDR is already in conversation.
Combining Social Signals for an Engagement Strategy
Each social signal type provides a single dimension of insight. The real power comes from combining them. Here is how to build a multi-signal engagement strategy that catches companies at exactly the right moment.
The Signal Stack Approach
Instead of configuring each signal in isolation, think of them as layers in a stack. Each layer adds confidence to the buyer intent:
- Layer 1: Company Followers. This is your broadest filter. Configure it with a moderate threshold (15-20% growth) to build a watchlist of companies gaining attention.
- Layer 2: Company Page Engagement. For companies on your watchlist, monitor whether the follower growth is accompanied by increased engagement. Growth without engagement is often paid (ads, sponsorships). Growth with engagement is organic momentum.
- Layer 3: Social Reactions. Narrow further by watching for individual posts that break out. A company with growing followers, rising engagement, and a viral post is in the middle of a market moment.
- Layer 4: Social Mentions. Check whether people outside the company are talking about it. External validation confirms that the momentum is not just self-promotion.
- Layer 5: Influencer Engagement. The strongest confirmation. When industry influencers start paying attention, the company is on the verge of a breakout.
Implementation with Webhooks
Configure all five signals with webhook URLs that point to a single processing endpoint. In your backend, score companies based on how many signal layers they have triggered:
Score 1: Follower growth only → Add to watchlist
Score 2: Followers + page engagement → Monitor closely
Score 3: Followers + engagement + reactions → Warm lead
Score 4: Three signals + external mentions → Hot lead
Score 5: All five signals triggered → Priority outreachYou can implement this scoring logic by aggregating webhook events in your CRM or a dedicated database. For webhook setup and delivery guarantees, refer to Real-Time Intent Signals: Setting Up Rodz Webhooks.
Timing Your Outreach
Social signals are time-sensitive. A company that went viral last week is old news next month. Here are the recommended outreach windows:
- Social mentions spike: Reach out within 48 hours. Reference the specific conversation.
- Reaction spike on a post: Reach out within 24 hours while the post is still visible in feeds.
- Influencer engagement: Reach out within 72 hours. Use the influencer interaction as a conversation anchor.
- Page engagement growth: You have a wider window (1-2 weeks) since this is a trend, not a moment.
- Follower growth: Similar to page engagement, act within 1-2 weeks of the spike.
Avoiding False Positives
Not every spike indicates buyer intent. Here are common false positives and how to handle them:
- Paid campaigns. A sudden follower increase from LinkedIn ads is less meaningful than organic growth. Cross-reference with
company-page-engagementto check whether the new followers are engaging. - Controversy. A spike in mentions with negative sentiment is not an opportunity. Always check the
sentiment_breakdownin your mention payloads. - Seasonal patterns. Some industries see regular engagement spikes (e.g., retail around the holidays). Use rolling baselines rather than fixed thresholds to account for this.
For full details on filter parameters, pagination, and error handling across all endpoints, consult the Rodz API Reference.
Frequently Asked Questions
How often are social signals updated?
The Rodz platform scans social platforms on a rolling basis. LinkedIn data is refreshed every 6 hours. Twitter/X and Reddit data is refreshed every 4 hours. When a signal threshold is met, the webhook fires within minutes. You can check the latest scan timestamp in the triggered_at field of each webhook payload.
Can I monitor specific people, not just companies?
Yes. The social-mentions and social-reactions signals both support an optional tracked_profiles filter where you can provide LinkedIn profile URLs or names of specific executives. This is particularly useful for tracking decision-makers at key accounts.
What LinkedIn data does Rodz access?
Rodz monitors publicly available data: company page posts, follower counts, engagement metrics on public posts, and public profile activity. It does not access private messages, closed groups, or data behind LinkedIn’s login wall. All data collection complies with platform terms of service.
How do I avoid being overwhelmed with webhook notifications?
Use the threshold and filter parameters aggressively. Start with high thresholds (e.g., engagement_multiplier: 5.0 instead of 2.0) and narrow your industry and geography filters. You can always loosen them later. Additionally, configure a single processing endpoint that aggregates and scores signals rather than acting on each one individually.
Can I combine social signals with other Rodz signal types?
Absolutely. Social signals become even more powerful when combined with financial and hiring signals. For example, a company that shows follower growth (social signal) and just posted 10 new engineering roles (job-offers signal) is almost certainly in a growth phase. You can configure all signal types through the same API and route them to the same webhook endpoint. See How to Configure Your First Intent Signal for the full list of 14 signal types.
What happens if a signal fires but the underlying data changes?
Rodz signals are event-based, not state-based. Once a signal fires, it represents a snapshot of the moment the threshold was crossed. If a company’s follower count drops back down after the signal was triggered, the original event remains in your signal feed. However, if you re-query the company’s data through the enrichment endpoints, you will see the updated numbers.
Are there rate limits on social signal configurations?
The same rate limits apply across all Rodz API endpoints: 100 requests per minute per API key. There is no separate limit on the number of active signal configurations, but each plan tier has a maximum number of monitored companies. Check the API Reference for details on rate limits and pagination.
How do I test a social signal configuration without waiting for real data?
Use the signal simulation endpoint. Send a POST request to /signals/{id}/simulate with a sample company ID, and Rodz will return what the webhook payload would look like if the signal had triggered. This lets you validate your webhook processing logic before any real data flows through. Full endpoint documentation is available at api.rodz.io/docs.