Python Guide

Installation

No SDK required — just requests:

pip install requests

Basic usage

import requests

BASE_URL = "https://finedgelabs.com/api/data"

# Search for a company (no auth needed)
resp = requests.get(f"{BASE_URL}/companies/search", params={"q": "Apple"})
companies = resp.json()

# Get segments for AAPL
resp = requests.get(f"{BASE_URL}/companies/AAPL/segments")
data = resp.json()

for seg in data["segments"]:
    revenue = seg.get("revenue")
    print(f"{seg['name']}: ${revenue / 1e9:.1f}B" if revenue else f"{seg['name']}: N/A")

Export to a pandas DataFrame

import pandas as pd
import requests

resp = requests.get(
    "https://finedgelabs.com/api/data/companies/AAPL/segments",
)
segments = resp.json()["segments"]
df = pd.DataFrame([
    {
        "segment": s["name"],
        "revenue": s.get("revenue"),
        "operating_income": s.get("operating_income"),
    }
    for s in segments
])
print(df.to_string(index=False))

Error handling

resp = requests.get(url)
if resp.status_code == 404:
    print("Company not found")
elif resp.status_code == 429:
    print("Rate limited — slow down")
elif resp.status_code == 200:
    data = resp.json()
else:
    print(f"Error: {resp.status_code} — {resp.text}")