Find Risk Factors with Semantic Search

curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/search/semantic?q=supply%20chain%20disruption%20risks%20in%20semiconductor%20industry&limit=5"

import os

from secapi_client import SecApiClient

client = SecApiClient(api_key=os.environ["SECAPI_API_KEY"])

results = client.semantic_search(
    q="supply chain disruption risks in semiconductor industry",
    limit=5,
)

for hit in results["sections"]["data"]:
    print(f"[{hit.get('score', 0):.3f}] {hit.get('companyName')} ({hit.get('form')} {hit.get('filingDate')})")
    print(f"  Section: {hit.get('section_key')}")
    print(f"  {hit.get('snippet', '')[:200]}...")
    print()

import { SecApiClient } from "@secapi/sdk-js";

const client = new SecApiClient({
  apiKey: process.env.SECAPI_API_KEY!,
});

const results = await client.semanticSearch({
  q: "supply chain disruption risks in semiconductor industry",
  limit: 5,
});

for (const hit of results.sections.data) {
  console.log(`[${(hit.score ?? 0).toFixed(3)}] ${hit.companyName} (${hit.form} ${hit.filingDate})`);
  console.log(`  Section: ${hit.section_key}`);
  console.log(`  ${(hit.snippet ?? "").slice(0, 200)}...`);
  console.log();
}

[0.943] NVIDIA Corp (10-K 2024-02-21)
  Section: Risk Factors
  Our operations depend on the ability of our suppliers to deliver components
  in a timely manner. Global semiconductor supply constraints, geopolitical
  tensions, and natural disasters could materially impact...

[0.921] Advanced Micro Devices Inc (10-K 2024-01-31)
  Section: Risk Factors
  We rely on third-party manufacturers, primarily TSMC, to produce our
  products. Disruptions to our supply chain, whether due to pandemic, trade
  restrictions, or capacity constraints...

[0.908] Intel Corp (10-K 2024-01-26)
  Section: Risk Factors
  Our manufacturing operations and supply chain are subject to risks
  including shortages of materials, equipment failures, and geopolitical
  events that could affect our ability to meet customer demand...

curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/search/semantic?q=cybersecurity%20incident%20disclosure%20requirements&ticker=AAPL&form=10-K&limit=10"

results = client.semantic_search(
    q="cybersecurity incident disclosure requirements",
    ticker="AAPL",
    form="10-K",
    limit=10,
)

for hit in results["sections"]["data"]:
    print(f"{hit.get('companyName')}: {hit.get('snippet', '')[:150]}...")

const results = await client.semanticSearch({
  q: "cybersecurity incident disclosure requirements",
  ticker: "AAPL",
  form: "10-K",
  limit: 10,
});

for (const hit of results.sections.data) {
  console.log(`${hit.companyName}: ${(hit.snippet ?? "").slice(0, 150)}...`);
}

QUERY = "artificial intelligence regulatory risk"

for year in [2022, 2023, 2024]:
    results = client.semantic_search(
        q=QUERY,
        ticker="MSFT",
        form="10-K",
        filing_year=year,
        limit=1,
    )

    if results["sections"]["data"]:
        hit = results["sections"]["data"][0]
        print(f"--- {year} (score: {hit.get('score', 0):.3f}) ---")
        print(f"{hit.get('snippet', '')[:300]}")
        print()
    else:
        print(f"--- {year}: No matching disclosure ---")
        print()

--- 2022 (score: 0.812) ---
We are investing significantly in artificial intelligence capabilities. The
regulatory environment for AI is evolving and uncertain, which could affect our
ability to develop and deploy AI-powered products and services...

--- 2023 (score: 0.891) ---
The rapid adoption of generative AI technologies has increased regulatory
scrutiny globally. Proposed regulations in the EU, US, and other jurisdictions
could impose significant compliance costs and restrict certain AI applications...

--- 2024 (score: 0.934) ---
AI regulation is advancing rapidly across major markets. The EU AI Act, US
executive orders on AI safety, and emerging frameworks in Asia create a complex
compliance environment. Our AI investments face risks from divergent regulatory
requirements, potential liability frameworks, and restrictions on training data...