כפי שדווח, מזוהה לפי מזהה,
נבנה למדור המתודולוגיה.

study_sample.py

from openfilings import Client
import pandas as pd

client = Client(api_key="of_...")  # or OPENFILINGS_API_KEY

# Filing history for one market, then KPIs into a frame
filings = client.filings.list("AAPL", market_id="us", limit=50)
rows = []
for f in filings.filings:
    if f.form_type not in ("10-K", "10-Q"):
        continue
    kpis = client.filings.kpis(f.id)
    rows.append({
        "filing_id": f.id,
        "form_type": f.form_type,
        "filing_date": f.filing_date,
        "revenue": kpis.canonical.get("revenue"),
        "gross_margin": kpis.canonical.get("gross_margin"),
    })

df = pd.DataFrame(rows)
print(df.head())

section search

# Full-text search over filing section bodies (FTS — not LIKE)
hits = client.filings.search(
    "supply chain concentration",
    registry="sec",
    limit=20,
)
for hit in hits.items:
    print(hit.get("filing_id"), hit.get("section_key"), hit.get("snippet"))