---
title: "Follow snapshot"
method: GET
path: "/follows/snapshot/{username}"
tags: ["Follows"]
---

# Follow snapshot

`GET /follows/snapshot/{username}`

## Request

- Base URL: `https://frontrun.vc/v1`
- URL: `https://frontrun.vc/v1/follows/snapshot/{username}`
- Auth: API key in header `X-API-Key`

Returns the most recent stored full follow list for a tracked account (latest snapshot, not a live X fetch). Costs 4 credits. Useful for auditing what an investor already follows; for change detection use /follows/new instead. The username must be one of your tracked accounts.

## Path parameters

- `username` string, required

## Response `200`

Latest follow snapshot.

- object
  - `username` string
  - `as_of` string: Snapshot date.
  - `follow_count` integer
  - `follows` FollowEntity[]
    - `twitter_user_id` string
    - `username` string
    - `name` string
    - `description` string
    - `verified` boolean
    - `profile_image_url` string
    - `classification` object: AI classification of the entity.
      - `is_company` boolean: Whether the entity is classified as a company.
      - `confidence` string: Classification confidence.
      - `sector` string: Primary sector (e.g. "AI/ML", "DeFi").
      - `entity_type` string: Entity type (e.g. "startup", "investor").
  - `cost_credits` integer: Credits charged for this call.
  - `balance_credits` integer: Remaining credit balance after this call.

## Other responses

- `401`: Missing, invalid, inactive, or expired API key.
- `402`: Insufficient credits for this operation. Top up from the developer page or enable auto-refill.
- `429`: Rate limit or daily credit cap reached. Retry after the indicated reset time.

---

[API](https://skmtc.dev/frontrun/apis/frontrun-api.md) · [All operations](https://skmtc.dev/frontrun/apis/frontrun-api/llms.txt) · [OpenAPI document](https://skmtc.dev/frontrun/apis/frontrun-api/revisions/6880b29e94c9?raw)