API reference

The same data as the dashboard, as JSON and CSV, for your own systems. Part of the Enterprise plan.

Authentication

Send the licence key from your Enterprise subscription as a bearer token. Keys stop working when a subscription ends.

curl -H "Authorization: Bearer $HC_KEY" https://hardestmarket.com/api/hc/company/7203

Endpoints

MethodPathReturns
GET/api/hc/companiesEvery company with its latest headline figures, plus the list of industries and size bands.
GET/api/hc/company/{securities code}One company: latest figures with basis and notes, industry percentiles, every filing since 2024, every subsidiary, its industry benchmarks and six similar-sized peers.
GET/api/hc/industry/{slug}An industry: its companies, benchmarks by size band and median trends.
GET/api/hc/benchmarksEvery benchmark cell, keyed industry|size: 25th percentile, median, 75th percentile and count.
GET/api/hc/pay-rangesMakana Partners pay ranges.
GET/api/hc/export/companies.csvLatest figures as CSV. Filters: industry, size, market, sec (comma-separated).
GET/api/hc/export/history.csvEvery filing since 2024 as CSV; same filters.
GET/api/hc/export/subsidiaries.csvEvery subsidiary as CSV; same filters.
GET/api/hc/mhlw/search?q=Employers in MHLW's women's-advancement database, listed and unlisted, by Japanese name or 13-digit corporate number.
GET/api/hc/mhlw/employer/{corporate number}One unlisted employer: MHLW figures (overtime, paid leave, women among officers and hires, retention, tenure, leave by gender, pay ratios), policies, certifications, benchmarks for its JSIC division and size band, percentiles.
GET/api/hc/mhlw/benchmarksMHLW benchmark cells keyed division|size over every employer with 101+ staff.
GET/api/hc/export/employers.csvEvery unlisted employer with 101+ staff as CSV. Filters: industry (JSIC division, Japanese or English), size, pref, foreign=1.

Listed companies' records carry their MHLW entry as mhlw (v holds the figures keyed overtime_hours, paid_leave_uptake, women_officers, women_supervisors, women_share_of_hires, women_share_of_workforce, retention10_f, retention10_m, tenure_f, tenure_m, female_childcare_leave, women_managers, male_childcare_leave and the three pay ratios) and, where confirmed, foreign with the parent and its country.

Fields

Figures are keyed employees, avg_salary_yen, avg_age, avg_tenure, female_manager_ratio, male_childcare_leave, pay_gap_all, pay_gap_regular and pay_gap_nonregular (women's pay as a percentage of men's). On a company record each figure is an object: v the value; filed the value as filed where we changed it; qc and note what we changed and why; sub the subsidiary it was reported for; lb the legal basis of the leave figure. Industry slugs are those used on the industry pages, such as banks or information-and-communication.

Licence

For use within your organisation, including internal tools and analysis. Do not republish the dataset or resell it. Quote figures with credit to "Japan Human Capital Data, The Hardest Market". Questions: editor@hardestmarket.com.