GET /v1/preview/:handle
Preview an account before tracking it. Returns profile summary, signal potential score, tracking recommendation, and sector hints.
Cost: $0.01 per call
curl "https://frontrun.vc/v1/preview/stealth_ai_co" \
-H "X-API-Key: your_api_key"Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
handle | string (path) | -- | X username to preview. Required. |
Response
{
"handle": "stealth_ai_co",
"name": "StealthAI",
"bio": "Automating enterprise workflows with LLMs",
"followers": 12400,
"following": 843,
"profile_image": "https://pbs.twimg.com/...",
"sector_hint": "AI/ML",
"signal_potential": {
"score": 0.82,
"hints": [
"Followed by 3 tracked VCs",
"High growth in followers (2x in 90 days)",
"Sector aligns with active VC interest"
],
"recommendation": "track"
},
"is_tracked": false,
"cost_cents": 5,
"balance_cents": 4900
}| Field | Type | Description |
|---|---|---|
signal_potential.score | number | Signal potential from 0 to 1. Higher means more likely to surface in reports. |
signal_potential.recommendation | string | One of "track", "maybe", or "skip". |
is_tracked | boolean | Whether this account is already in your tracked set. |