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 tracked VC followers.

Cost: 16 credits per call. If no signal can be resolved (no mentions found and no tracked VC 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-VC 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 tracked VCs that follow this company.
tracked_vc_countintegerNumber of tracked VCs following this company.