API Reference
GET /v1/follows/enriched

GET /v1/follows/enriched

New follows with full enrichment: AI classification + your custom rules + your custom tags, all merged into each result.

This is the most powerful endpoint for building custom workflows.

Cost: $0.05 per call

curl "https://frontrun.vc/v1/follows/enriched?since=48h" \
  -H "X-API-Key: your_api_key"

Parameters

ParameterTypeDefaultDescription
sincestring (query)"24h"Time window: "24h", "48h", "7d", etc.
usernamestring (query)--Filter to a specific tracked account.

Response

{
  "since": "2026-03-07T04:00:00.000Z",
  "accounts_checked": 50,
  "total_new_follows": 12,
  "cost_cents": 5,
  "balance_cents": 4840,
  "results": [
    {
      "tracked_account": "pmarca",
      "new_follows_count": 3,
      "new_follows": [
        {
          "twitter_user_id": "1111111111",
          "username": "stealth_ai_co",
          "name": "StealthAI",
          "description": "Automating enterprise workflows with LLMs",
          "verified": true,
          "classification": {
            "is_company": true,
            "confidence": "high",
            "sector": "AI/ML",
            "entity_type": "startup"
          },
          "custom": {
            "tags": ["thesis-match", "watchlist"],
            "sector": "AI Infrastructure",
            "priority": "high",
            "matched_rule": "AI Infra"
          }
        }
      ]
    }
  ]
}

How custom data merges

  1. AI classification is always included
  2. Custom tags (from POST /v1/tags) are merged — manual overrides take priority
  3. Classification rules (from POST /v1/classify/rules) are evaluated against each entity
  4. If both a manual tag and a rule match, they're merged (tags combined, manual sector takes priority)