GET /v1/follows/new
Detect new follows across your tracked accounts within a time window.
Cost: $0.05 per call (+$0.03/entity with classify=true)
curl "https://frontrun.vc/v1/follows/new?since=48h" \
-H "X-API-Key: your_api_key"Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
since | string (query) | "24h" | Time window. Accepts hours ("24h", "48h"), days ("7d", "14d", "30d"), or ISO date. |
username | string (query) | -- | Filter to a specific tracked account. Omit to check all. |
classify | string (query) | -- | Set to "true" to include AI classification. |
Response
{
"since": "2026-03-05T04:00:00.000Z",
"accounts_checked": 3,
"total_new_follows": 5,
"cost_cents": 5,
"balance_cents": 4845,
"results": [
{
"tracked_account": "pmarca",
"new_follows_count": 2,
"new_follows": [
{
"twitter_user_id": "1234567890",
"username": "newai_startup",
"name": "NewAI",
"description": "Building the future of AI infrastructure",
"verified": true,
"profile_image_url": "https://pbs.twimg.com/..."
}
]
}
]
}With classification
curl ".../v1/follows/new?since=7d&classify=true" \
-H "X-API-Key: your_api_key"Each new follow includes AI-powered classification:
{
"twitter_user_id": "1234567890",
"username": "newai_startup",
"name": "NewAI",
"description": "Building the future of AI infrastructure",
"verified": true,
"classification": {
"is_company": true,
"confidence": "high",
"sector": "AI/ML",
"entity_type": "startup"
}
}| Field | Type | Description |
|---|---|---|
classification.is_company | boolean | Whether this account represents a company/startup. |
classification.confidence | string | "high", "medium", or "low". |
classification.sector | string | Primary sector: "AI/ML", "Fintech", "Enterprise SaaS", "Crypto/Web3", etc. |
classification.entity_type | string | "startup", "growth_company", "enterprise", "vc_fund", "accelerator", "media", "individual", etc. |
Filter to one account
curl ".../v1/follows/new?username=pmarca&since=24h"Only returns new follows for @pmarca.