---
title: "Preview an account"
method: GET
path: "/preview/{handle}"
tags: ["Company", "Tracking"]
---

# Preview an account

`GET /preview/{handle}`

## Request

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

Preview any X account before tracking it: live profile summary, computed signal-potential score (0 to 1), a tracking recommendation (strong_track, consider_tracking, or low_signal), and a sector hint. Costs 4 credits. Use it to qualify /discover candidates before adding them with POST /track. Rate limited to 20 requests/hour per key (429 beyond that), separate from credit charges.

## Path parameters

- `handle` string, required

## Response `200`

Account preview.

- object
  - `handle` string
  - `name` string
  - `bio` string
  - `followers` integer
  - `following` integer
  - `profile_image` string
  - `created_at` string
  - `sector_hint` string, nullable
  - `signal_potential` object
    - `score` number: 0 to 1.
    - `hints` string[]
    - `recommendation` 'strong_track' | 'consider_tracking' | 'low_signal'
  - `is_tracked` boolean
  - `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)