---
title: "Discover recommendations"
method: GET
path: "/discover"
tags: ["Signal"]
---

# Discover recommendations

`GET /discover`

## Request

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

Personalized coverage-expansion recommendations: entities followed by 2+ of your tracked accounts that you are not tracking yet, scored by signal strength (0 to 1) and matched against your custom classification rules. Costs 60 credits. Typical flow: /discover, then GET /preview/{handle} on candidates, then POST /track the good ones.

## Query parameters

- `sector` string
- `min_signal` number
- `limit` integer
- `scope` string

## Response `200`

Recommendations.

- object
  - `tracked_accounts_analyzed` integer
  - `recommendations` object[]
    - `handle` string
    - `name` string
    - `sector` string
    - `entity_type` string
    - `is_company` boolean, nullable
    - `followed_by` string[]
    - `signal_score` number
    - `matched_rule` string, nullable
    - `reason` string
    - `is_tracked` boolean
  - `total_candidates` integer
  - `filters` object
    - `sector` string
  - `rules_applied` string[]
  - `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.

## 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/discover/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)