---
title: "New follows"
method: GET
path: "/follows/new"
tags: ["Follows"]
---

# New follows

`GET /follows/new`

## Request

- Base URL: `https://frontrun.vc/v1`
- URL: `https://frontrun.vc/v1/follows/new`
- Auth: API key in header `X-API-Key`

Detect new follows across your tracked accounts within a time window, grouped per tracked account. Costs 16 credits. Only tracked accounts with an established baseline are checked; with no ready accounts you get an empty result plus a hint message, not an error. Set classify=true to include cached AI classification on each new follow at no extra cost. Prefer /follows/enriched (same 16-credit price) when you want sector, keyword, entity-type, or tag filters and your custom rules merged in.

## Query parameters

- `since` string
- `hours` integer
- `username` string
- `classify` 'true' | 'false'
- `offset` integer
- `limit` integer
- `cursor` string
- `scope` string

## Response `200`

New follows grouped by tracked account.

- object
  - `since` string, date-time
  - `accounts_checked` integer
  - `total_new_follows` integer
  - `total` integer: Total tracked-account groups with new follows.
  - `returned` integer
  - `offset` integer
  - `has_more` boolean
  - `results` object[]
    - `tracked_account` string
    - `as_of` string: Snapshot date the diff is computed against.
    - `new_follows_count` integer
    - `new_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.
  - `next_cursor` string, nullable: Opaque cursor for the next run. Null while has_more is true, by design, not an error: the cursor marks the end of the whole matched window, so it is issued on the final page only. Call again with offset set to next_offset until has_more is false, then take next_cursor from that final page.
  - `next_offset` integer: Present while has_more is true: the offset value for the next page of this window (offset + returned).
  - `next_cursor_note` string
  - `cursor_note` string

## 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.

## Changes

- **2026-10-19** `6880b29e94c9`: 1 info
  - added the new optional `query` request parameter `scope`

[Operation history](https://skmtc.dev/frontrun/apis/frontrun-api/changes/follows/new/get.md)

---

[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)