Integrations
Python

Python

Use the Frontrun API from Python with requests or any HTTP client.

Installation

pip install requests

Basic usage

import requests
 
BASE_URL = "https://frontrun.vc/v1"
HEADERS = {"X-API-Key": "your_api_key"}
 
 
def frontrun_get(path, params=None):
    response = requests.get(f"{BASE_URL}{path}", headers=HEADERS, params=params)
    response.raise_for_status()
    return response.json()
 
 
def frontrun_post(path, data):
    response = requests.post(f"{BASE_URL}{path}", headers=HEADERS, json=data)
    response.raise_for_status()
    return response.json()

Examples

Track an account

result = frontrun_post("/track", {"username": "pmarca"})
print(result)

Get new follows

new_follows = frontrun_get("/follows/new", {"since": "48h", "classify": "true"})
 
for account in new_follows["results"]:
    print(f"\n{account['tracked_account']}:")
    for follow in account["new_follows"]:
        sector = follow.get("classification", {}).get("sector", "Unknown")
        print(f"  @{follow['username']} ({sector})")

Check convergence

convergence = frontrun_get("/convergence", {"threshold": 3, "since": "7d"})
 
for signal in convergence["convergences"]:
    followers = ", ".join(signal["followed_by"])
    print(f"{signal['name']} — followed by {followers}")

Get trending

trending = frontrun_get("/trending", {"since": "7d", "classify": "true", "limit": 10})
 
for company in trending["trending"]:
    print(f"#{company['follower_count']} {company['name']} @{company['username']}")

Account activity

activity = frontrun_get("/vc/pmarca/activity", {"since": "30d"})
 
print(f"Follows/week: {activity['follows_per_week']}")
print(f"Sectors: {activity['sector_breakdown']}")

Search

results = frontrun_get("/search", {"sector": "AI/ML", "entity_type": "startup"})
 
for company in results["results"]:
    print(f"@{company['username']}{company['description']}")