Get free API key
Docs menuexpand_more
travel_exploreTry in the API Viewer

Guides

Endpoints

search
appsAll APIs
functionHow metrics are calculated

Cookbook

Find a securities code by company name

Search by part of a Japanese or English company name to get securities codes and names. It is the first step before calling other endpoints.

Key points

  • check_circlePass part of a name to /stable/search-name to get up to 50 partial matches.
  • check_circleJapanese and English both work. Enter at least two characters.
  • check_circleEach call uses 1 token.

Endpoints to use

Code

Replace YOUR_API_KEY with a key issued in your dashboard. Switch languages with the tabs.

Code example
curl -sG "https://api.zenithcode.net/stable/search-name" \
  --data-urlencode "query=トヨタ" \
  --data-urlencode "limit=5" \
  -H "x-api-key: YOUR_API_KEY"

How the code works

  1. 1Put part of the name in query. Each language's URL builder encodes Japanese text.
  2. 2The response is an array; each row has symbol (securities code), nameJa and nameEn.
  3. 3Pass the symbol you found to income-statement and other endpoints.

Things to note

  • errorGeneric words such as "Holdings" return many candidates. Search with a distinctive part of the name.
  • errorIf you already know the code, use /stable/search-symbol.

FAQ for investors and developers

Can I search by English name?expand_more

Yes. Part of the English name (for example Toyota) also works.

Do some securities codes contain letters?expand_more

Yes. Companies listed from 2024 onward may have codes such as 130A. The API accepts them as they are.

FAQ for AI builders and researchers

How are search results ordered?expand_more

This page does not define an order. When identifying a company, check the full name and code before using it.

What should an AI watch for when identifying a company?expand_more

Similar names exist. Tell it to fetch several candidates and confirm the full name and code before the next call.

gavel

Disclaimer

This page explains how to use a Japanese equity data API and how its data is defined. It is not a solicitation to invest or a recommendation to buy or sell any security. The content reflects information at the time of writing and is not guaranteed to be accurate or complete. Investment decisions are your own responsibility.

What you may show or provide to third parties depends on your plan and Article 8 of the Terms. Exchange data such as stock prices may not be shown to third parties on any plan. Terms, Article 8 · Data sources and terms of use