Follows

New follows

Changed on

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.

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

Query parameters

sincestring
Example:24h

Time window: relative ("24h", "7d") or absolute date ("YYYY-MM-DD"). Default "24h".

hoursinteger

Alternative to since - window size in hours (e.g. hours=48 equals since=48h).

usernamestring

Restrict to a single tracked account.

classify'true' | 'false'

Set to "true" to include cached AI classification on each new follow (no extra charge).

offsetinteger

Pagination offset (default 0).

limitinteger

Maximum results to return (default 50, max 200).

cursorstring
Example:frc1_eyJ2IjoxLCJzIjoiOWY0YyIsImQiOiIyMDI2LTA4LTA3In0.Xq9

Opaque watermark from a previous response's next_cursor. Resumes exactly where that run stopped, so a scheduled job that retries neither double counts nor drops records. Overrides since when present. Cursors are signed and scoped to the endpoint, API key and filters; a modified or cross-scope cursor returns 400 with error_code invalid_cursor. Persist next_cursor only AFTER you have processed the response.

scopestring
Example:tracked

Whose follows to read: tracked (default, your tracked accounts), network (the whole Frontrun network; paid Pro and Enterprise) or list:<id> (one of your lists, with its sectors). See /docs/reference/scopes.

Response

New follows grouped by tracked account.

sincestring date-time
accounts_checkedinteger
total_new_followsinteger
totalinteger

Total tracked-account groups with new follows.

returnedinteger
offsetinteger
has_moreboolean
cost_creditsinteger

Credits charged for this call.

balance_creditsinteger

Remaining credit balance after this call.

next_cursorstring 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_offsetinteger

Present while has_more is true: the offset value for the next page of this window (offset + returned).

next_cursor_notestring
cursor_notestring

Changes