Docs
Use Cases

Use Cases

Deal sourcing

Track investor accounts, then pull the startups they are converging on.

# Track accounts
curl -X POST .../v1/track -d '{"username": "pmarca"}'
curl -X POST .../v1/track -d '{"username": "naval"}'
 
# Your companies, own list first. Sort by tracked_followers.
curl ".../v1/companies?source=your_list&since=7d"
 
# New follows, companies only
curl ".../v1/follows/enriched?since=7d&entity_type=company"

GET /v1/companies only returns companies, and tracked_followers says how many of your tracked accounts follow each one. Sort by it to see which startups your accounts are converging on, then cross-reference with your existing deal pipeline.

/v1/convergence and /v1/trending return startups only: no people, investors, VC firms, media or big established brands. Use them to see what startups your accounts are converging on this week. /v1/companies stays the full catalog and the first call.

Custom classification

Build your own taxonomy on top of Frontrun's AI classification:

# Flag companies in your space
curl -X POST .../v1/classify/rules \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Competitors",
    "conditions": {"bio_keywords": ["sales automation", "revenue intelligence"]},
    "actions": {"tags": ["competitor"], "priority": "high"}
  }'
 
# All future enriched calls auto-apply your rules
curl ".../v1/follows/enriched?since=7d"

Slack / Telegram / webhook alerts

Push signals to your team's workflow:

Slack example

import requests
 
FRONTRUN = "https://frontrun.vc/v1"
HEADERS = {"X-API-Key": "your_api_key"}
SLACK_WEBHOOK = "https://hooks.slack.com/services/..."
 
convergence = requests.get(
    f"{FRONTRUN}/convergence",
    headers=HEADERS,
    params={"threshold": 3, "since": "24h"}
).json()
 
for signal in convergence.get("convergences", []):
    followers = ", ".join(signal["followed_by"])
    requests.post(SLACK_WEBHOOK, json={
        "text": f"*Convergence signal*: {signal['name']} (@{signal['username']})\n"
                f"Followed by: {followers}"
    })

Telegram example

import requests
 
FRONTRUN = "https://frontrun.vc/v1"
HEADERS = {"X-API-Key": "your_api_key"}
TELEGRAM_BOT_TOKEN = "your_bot_token"
TELEGRAM_CHAT_ID = "your_chat_id"
 
convergence = requests.get(
    f"{FRONTRUN}/convergence",
    headers=HEADERS,
    params={"threshold": 3, "since": "24h"}
).json()
 
for signal in convergence.get("convergences", []):
    followers = ", ".join(signal["followed_by"])
    text = (f"*Convergence signal*: {signal['name']} (@{signal['username']})\n"
            f"Followed by: {followers}")
    requests.post(
        f"https://api.telegram.org/bot{TELEGRAM_BOT_TOKEN}/sendMessage",
        json={"chat_id": TELEGRAM_CHAT_ID, "text": text, "parse_mode": "Markdown"}
    )

Agent integration

Connect Frontrun to your AI agent via the MCP server or REST API. Your agent can monitor deal flow, flag opportunities, and surface signals without manual intervention. Have it start with GET /v1/companies (MCP: frontrun_companies), which lists your companies and is never empty on day one.

"Which startups are my tracked accounts converging on this week? Flag anything in AI."

See MCP Server and Claude Code for setup.

AuthenticationGET /v1/status