---
title: "Enriched new follows"
method: GET
path: "/follows/enriched"
tags: ["Follows", "Classification"]
---

# Enriched new follows

`GET /follows/enriched`

## Request

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

The most capable follow-signal endpoint: new follows with AI classification plus your custom classification rules and custom tags merged into each result, filterable by sector, keyword, entity type, or custom tag. Results include people as well as companies; for startup sourcing pass entity_type=company. Same 16-credit price as /follows/new, so use this whenever you want filtered results (e.g. sector=AI follows from the last 7d). Filters are substring matches; valid sector strings can be discovered via /sectors. On a new or thin account (account keys only; fewer than 10 of your own follows in the window, first page at offset 0, no cursor, no username filter) the response also carries starter_companies: companies from your 30-day starter set in your sectors, each with source "starter", filtered by the same sector and keyword, plus a starter_note. Never mixed into results. They come from the whole Frontrun network, not from accounts you track, and stop appearing once your own window fills.

## Query parameters

- `since` string
- `hours` integer
- `username` string
- `sector` string
- `keyword` string
- `entity_type` string
- `tag` string
- `offset` integer
- `limit` integer
- `cursor` string
- `scope` string

## Response `200`

Enriched new follows grouped by tracked account.

- object
  - `since` string, date-time
  - `accounts_checked` integer
  - `total_new_follows` integer
  - `total` integer
  - `returned` integer
  - `offset` integer
  - `has_more` boolean
  - `results` object[]
    - `tracked_account` string
    - `as_of` string
    - `new_follows_count` integer
    - `new_follows` object[]
      - `twitter_user_id` string
      - `username` string
      - `name` string
      - `description` string
      - `verified` boolean
      - `classification` Classification: 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").
      - `custom` CustomData: Your custom tags and rule matches merged into the entity.
        - `tags` string[]
        - `sector` string: Custom sector override.
        - `entity_type` string: Custom entity type override.
        - `notes` string
        - `priority` string
        - `matched_rule` string: Name of the classification rule that matched.
  - `filters` object
    - `sector` string
    - `keyword` string
    - `entity_type` string
    - `tag` string
  - `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
  - `starter_companies` object[]: Only when your own result is thin (see description). Starter rows, source "starter", from the whole Frontrun network, not your tracked accounts.
  - `starter_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/enriched/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)