Comparison set for one company across KR / US / TW / JP: the company plus its closest peers, chosen from the same industry group (SIC / KSIC / TWSE / EDINET classification, normalised to one shared bucket) and ranked by market-cap proximity with same-market names first. Falls back to pure size peers when the company has no classification. Also returns the company's business-segment revenue split where available (currently Japan, from 有価証券報告書 XBRL) — informational, not yet used for ranking.
Args:
- company: US ticker ('AAPL'), KR 6-digit code ('005930'), TW/JP 4-digit code ('2330', '7203'), or a company name (local or English).
- market: 'kr'|'us'|'tw'|'jp'|'eu' (optional) — disambiguates codes/names shared across markets (TW and JP both use 4-digit codes; 'eu' companies are addressed by ISIN).
- limit: 1-10 peers (default 5).
- same_market_only: true = restrict peers to the company's own market (default false — a KR chipmaker can sit next to a US one).
- rank: 'size' (default) = same industry group, nearest by market cap (or revenue where there is no price feed); 'segments' = rank by business-mix similarity — each company's segment revenue shares are mapped to standard industries (companies without segment data count as 100% their own industry) and compared by cosine similarity, ties broken by size. Conglomerates (Sony: games/music/pictures/electronics/finance) then get conglomerate peers instead of whichever single bucket they were filed under.
- response_format: 'markdown' (default) or 'json'.
Returns: {company:{name, name_en, market, ticker|code}, basis:'sector'|'size'|'segments', sector:{group, label, name}, industry_mix:{vector:{industry:share}, primary:[industry], from_segments:bool} (rank='segments' only), peers:[{name, name_en, market, ticker|code, market_cap, per, pbr, roe, rev_cagr_3y, rs_pctile, ret_120d, similarity?, primary_industry?, has_segments?}], segments:{fiscal_year, rows:[{segment, kind, revenue_external, share_pct}]}, notes}.
Examples:
- {company:'7203'} -> Toyota + transportation-equipment peers, with its Automotive / Financial Services segment split
- {company:'005930', same_market_only:true} -> Samsung Electronics + KR tech-hardware peers only
- {company:'6758', rank:'segments'} -> Sony ranked against other multi-segment conglomerates by business mix
Use when: building a comparison table or choosing competitors for a financial comparison. Don't use for strategy screens (screen_*) or for full financial statements (get_dart_financials / get_edgar_financials).
Notes: company-level classification only; segment names may be geographic (Japan/Asia/USA) when a company defines its reportable segments by region. Market cap is in the company's listing currency, so cross-market rank by proximity is approximate. Revenue-proximity fallbacks (no market cap: JP, EU) convert revenue to EUR with ECB daily rates first, so mixed-currency European filers rank sensibly.
Errors: unknown/ambiguous company -> candidate list; no classification -> basis='size' with a note.
ConnectorAPI key