Docs
API Reference
GET /v1/company/:handle/signals

GET /v1/company/:handle/signals

Social signal analysis for a company. Returns buzz score, sentiment, mention count, notable mentions, and which of your tracked accounts follow them.

Cost: 16 credits per call. If no signal can be resolved (no mentions found and no tracked account follows the company), you are not charged.

curl "https://frontrun.vc/v1/company/stealth_ai_co/signals" \
  -H "X-API-Key: your_api_key"

Parameters

ParameterTypeDefaultDescription
handlestring (path)--X username of the company. Required.

Response

{
  "handle": "stealth_ai_co",
  "signals": {
    "buzz_score": 42,
    "sentiment": "positive",
    "mention_count": 42,
    "notable_mentions": [
      {
        "author": "pmarca",
        "text": "StealthAI is doing something really interesting with workflow automation",
        "date": "2026-03-26",
        "likes": 1200
      },
      {
        "author": "paulg",
        "text": "One of the most promising AI startups I've seen this quarter",
        "date": "2026-03-22",
        "likes": 890
      }
    ],
    "tracked_vc_followers": ["pmarca", "naval", "paulg"],
    "tracked_vc_count": 3
  },
  "cost_credits": 16,
  "balance_credits": 9884
}
FieldTypeDescription
buzz_scoreintegerNumber of recent mentions found for the company.
sentimentstringOverall read: "positive" (mentions carry real engagement), "low_activity" (fewer than 3 mentions), or "neutral".
mentions_unavailablebooleanPresent and true only when the mention search failed upstream. The tracked-follower fields are still accurate; buzz_score and sentiment are not, so retry rather than reading a 0 as "nobody is talking about them".
tracked_vc_followersarrayUsernames of your tracked accounts that follow this company. The vc in the field name is historical; the tracked set is any X account you track, not only funds.
tracked_vc_countintegerNumber of your tracked accounts following this company.