{
  "name": "RealGeeks Company Registry API",
  "version": "1.1.0",
  "description": "One JSON schema for official company registers: France (INSEE Sirene/RNE), Norway (Brønnøysund), Finland (PRH/YTJ) and US SEC EDGAR filers. Keyless upstream open data, normalized.",
  "endpoints": {
    "search": "https://realgeeks-company-api.worker.beacon.host/v1/search?q=danone&country=fr|no|fi|us|all&limit=5",
    "company": "https://realgeeks-company-api.worker.beacon.host/v1/company?country=no&id=923609016",
    "openapi": "https://realgeeks-company-api.worker.beacon.host/openapi.json",
    "mcp": "https://realgeeks-company-api.worker.beacon.host/mcp (MCP Streamable HTTP; tools search_companies, get_company)"
  },
  "examples": [
    "https://realgeeks-company-api.worker.beacon.host/v1/search?q=equinor&country=no",
    "https://realgeeks-company-api.worker.beacon.host/v1/search?q=nokia&country=all&limit=3",
    "https://realgeeks-company-api.worker.beacon.host/v1/company?country=fr&id=552032534",
    "https://realgeeks-company-api.worker.beacon.host/v1/company?country=fi&id=0112038-9",
    "https://realgeeks-company-api.worker.beacon.host/v1/company?country=us&id=AAPL",
    "https://realgeeks-company-api.worker.beacon.host/v1/company?id=NO:923609016"
  ],
  "options": {
    "limit": "1-20 results per country (default 5). US search returns full records for the top 5, summary rows after that.",
    "officers": "0|1 — officers/roles where published (FR, NO). Default 1 on /v1/company, 0 on /v1/search.",
    "filings": "0|1 — filings (NO annual accounts, US SEC filings). Default 1 on /v1/company, 0 on /v1/search.",
    "max_filings": "1-100 (default 10)",
    "raw": "0|1 — include the untouched upstream record (default 0)"
  },
  "identifiers": {
    "fr": "SIREN (9 digits) or SIRET (14)",
    "no": "Organisasjonsnummer (9 digits)",
    "fi": "Y-tunnus 1234567-8",
    "us": "CIK or ticker"
  },
  "sources": {
    "fr": "https://recherche-entreprises.api.gouv.fr (Etalab Licence Ouverte 2.0)",
    "no": "https://data.brreg.no (NLOD 2.0)",
    "fi": "https://avoindata.prh.fi (CC BY 4.0)",
    "us": "https://www.sec.gov/edgar (public domain)"
  },
  "cors": "*",
  "pricing": {
    "free_tier": "50 lookups per day per IP, no key needed",
    "paid": "10,000 lookups for $9 (one-time license key, credits never expire)",
    "buy_url": "https://realgeeks.gumroad.com/l/company-api-10k",
    "auth": "Authorization: Bearer <license key>  (or X-License-Key header, or ?key=)"
  }
}