API Reference
GET /v1/follows/snapshot

GET /v1/follows/snapshot/:username

Returns the current follow list for a tracked account.

Cost: $0.01 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_cents": 2,
  "balance_cents": 4848,
  "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 balance
404Not tracking this account