Docs
API Reference
GET /v1/follows/snapshot

GET /v1/follows/snapshot/:username

Returns the current follow list for a tracked account.

Cost: 4 credits per call

curl https://frontrun.vc/v1/follows/snapshot/pmarca \
  -H "X-API-Key: your_api_key"

Parameters

ParameterTypeRequiredDescription
usernamestring (path)YesX username of the tracked account.

Response

{
  "username": "pmarca",
  "as_of": "2026-04-20T08:00:00Z",
  "follow_count": 70,
  "cost_credits": 4,
  "balance_credits": 9908,
  "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/..."
    }
  ]
}
FieldTypeDescription
as_ofstring (ISO 8601)Timestamp the snapshot reflects.
follow_countintegerTotal number of accounts being followed.
followsarrayArray of followed accounts with profile details.

Errors

StatusDescription
402Insufficient credits
404Not tracking this account