Docs
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: 16 credits 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.
sector / keyword / entity_type / tagstring (query)--Filter the returned follows.
cursorstring (query)--Opaque watermark from a previous response's next_cursor. Resumes exactly where that run stopped, so a retry never double-counts or drops records. Overrides since. See Budgets & Cursors.

Response

{
  "since": "2026-03-07T04:00:00.000Z",
  "accounts_checked": 50,
  "total_new_follows": 12,
  "has_more": false,
  "next_cursor": "frc1_eyJ2IjoxLCJzIjoiMWEyYi4uLiIsImQiOiIyMDI2LTA4LTA3In0.Kd3...",
  "cost_credits": 16,
  "balance_credits": 9948,
  "results": [
    {
      "tracked_account": "pmarca",
      "as_of": "2026-04-20T08:00:00Z",
      "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)