Search

Overview

The query is matched against both ticker and registered name across all three markets. Matches are ranked by exactness (ticker exact match first, then ticker prefix, then name substring). The response is intentionally small — this is for "type-ahead" UX, not bulk listing. If you need to walk the entire universe, use the per-section /tickers helper endpoints exposed by each ingestion module.

Results include the resolved market code so downstream calls can dispatch correctly. For US listings, the SEC cik is surfaced too — useful when you want to pass that as an identifier into other US-specific endpoints.

Parameters

Example

curl -H "X-API-Key: rk_YOUR_KEY" \
  "https://api.rockmoon.ai/v1/companies/search?q=samsung&limit=5"

import requests

r = requests.get(
    "https://api.rockmoon.ai/v1/companies/search",
    params={"q": "samsung", "limit": 5},
    headers={"X-API-Key": "rk_YOUR_KEY"},
)
for hit in r.json()["results"]:
    print(hit["ticker"], hit["market"], hit["name"])

const r = await fetch(
  "https://api.rockmoon.ai/v1/companies/search?q=samsung&limit=5",
  { headers: { "X-API-Key": "rk_YOUR_KEY" } },
);
const { results } = await r.json();

{
  "count": 3,
  "results": [
    { "ticker": "005930", "name": "Samsung Electronics Co., Ltd.",
      "market": "KR", "industry": "Semiconductors" },
    { "ticker": "009150", "name": "Samsung Electro-Mechanics",
      "market": "KR", "industry": "Electronic Components" },
    { "ticker": "207940", "name": "Samsung Biologics",
      "market": "KR", "industry": "Biotechnology" }
  ]
}

Notes

• Romanization: Korean and Japanese names are searchable by their English / romanized form. Native script (한글 / 漢字) is not yet indexed.
• Delisted issuers are excluded by default — search reflects the active universe only.