POST /v1/classify
Classify specific entities on demand - AI classification with your classification rules and custom tags merged in.
Cost: 16 credits per entity
curl -X POST https://frontrun.vc/v1/classify \
-H "X-API-Key: your_api_key" \
-H "Content-Type: application/json" \
-d '{"usernames": ["stealth_ai_co", "dev_infra_xyz"]}'Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
usernames | string[] (body) | -- | X usernames to classify. Required. Max 100 per request. Cost is 16 credits per entity found. |
twitter_user_ids | string[] (body) | -- | Alternative to usernames. Same 100-entity ceiling. |
max_credits | integer (body) | -- | Cap what this call may cost. 100 entities is up to 1,600 credits. Fails closed: over the ceiling, nothing runs and nothing is charged. See Budgets & Cursors. |
Response
{
"total": 2,
"cost_credits": 32,
"max_cost_credits": 32,
"balance_credits": 9880,
"results": [
{
"twitter_user_id": "1111111111",
"username": "stealth_ai_co",
"description": "Automating enterprise workflows with LLMs",
"classification": {
"is_company": true,
"confidence": "high",
"sector": "AI/ML",
"entity_type": "startup",
"sub_category": "Enterprise AI",
"tags": []
},
"custom": {
"tags": ["portfolio", "series-a"],
"sector": "AI Infrastructure",
"notes": "Series A target Q2."
}
}
]
}| Field | Type | Description |
|---|---|---|
classification | object | Frontrun's AI classification. |
custom | object | Your own tags, sector overrides, and notes for the entity - from your rules and tags. |
Build your own classification layer
- Classification Rules - auto-tag entities matching bio keywords, username patterns, or sectors. Free.
- Custom Tags - manually tag individual entities with sectors, types, and notes. Free.