データ仕様 — 介護施設・事業所の比較
ページの JSON（/path/index.json）
すべてのページに generated_at、data_through（オープンデータの時点）、source[]、license、
schema_url、canonical_url、language、data があります。事業所のページ（/kaigo/facility/<事業所番号>/）には
data.data_notes（詳細ページの取得期間と、施設の報告日の範囲）もあります。
比較表の行（市区町村ページ、/municipality/…/{service_code}）
facility_id | 事業所番号（10桁、厚労省の指定番号そのまま） |
|---|---|
name / address | 事業所名 / 所在地 |
operator / operator_corporate_number | 運営法人の名称 / 法人番号 |
same_operator_facilities | 同じ法人番号の事業所の数（全国、全サービス） |
capacity | 定員（人）。詳細ページの値を優先し、無ければオープンデータの値。0・無しは null |
opened_year / years_operating | 指定年（または事業開始年）/ 運営年数 |
cost_min_total_monthly_yen | 費用の目安（月額、円）。居室の種類があるときはいちばん安い値。読み取れない項目があれば null（画面では「要確認」） |
cost_options[] | 居室の種類ごとの月額（room_type, total_monthly_yen） |
cost_missing[] | 読み取れなかった項目（meal 食費, room 居住費, rent 家賃 など） |
staff_per_3_users | 利用者3人あたりの職員数（看護＋介護、常勤換算） |
nurse_share | 職員のうち看護職員の割合（0〜1） |
vs_legal | 法定基準（3人あたり1.0人）の何倍か。特養・老健・地域密着型特養のみ。数え方の違いで1.0を下回る施設があるため、画面では1.0以上のときだけ表示 |
users_basis | 利用者数に使った値: residents 直近の入所（入居）者数、capacity 詳細ページの定員、capacity_csv オープンデータの定員 |
has_detail | 詳細ページを取り込んだ施設か（施設系のサービスのみ true） |
lat / lon / page | 緯度経度（世界測地系）/ 事業所ページのパス |
事業所1件（/facility/{facility_id}）
事業所の基本情報（name, address, municipality_code 6桁の市区町村コード, lat, lon, phone, url, operator）と、
サービスごとの services[]。1つの事業所番号で複数のサービスを運営している場合は、すべて入ります。
services[].service_code | サービス番号（510 特養、520 老健、331 介護付き有料老人ホーム、320 グループホームなど）。label は画面の見出し、short_label は通称、note は一言の説明 |
|---|---|
reported_on / published_on / detail_fetched_at | 施設の報告日 / 都道府県の公表日 / tokeilab が詳細ページを取得した日時。報告日は施設が手で入力するため、明らかな誤り（年が 2000 年より前や未来）は null |
opened | year, basis（designation 指定年月日 / start 事業開始年月日）, years_operating, designation_date, start_date |
cost | kind（daily_x30 日額×30 / monthly 月額）, options[], components_yen, missing[], min_total_monthly_yen, note, meal_text / room_text（施設の原文） |
staffing | nurse_fte, care_fte（常勤換算）, users, users_basis, staff_per_3_users, nurse_share, legal_staff_per_3_users, vs_legal |
staff_counts | 看護・介護職員の常勤 / 非常勤の人数（実人数） |
residents | total（報告日時点の利用者数）, by_care_level, capacity, occupancy_pct, waiting_list |
rooms[] | 居室の種類（type）、室数（rooms）、1室の広さ（area_m2） |
detail_page | 公表システムの詳細ページ（原文） |
API の応答
ベース URL https://api.tokeilab.org。{"data": ..., "meta": {generated_at, data_through, source, license, schema_url, api_version, cost_units}}。
ヘッダ X-Cost-Units・X-Api-Version。エラーは RFC 9457（application/problem+json）。使い方は API の使い方。
一括ダウンロード（Parquet）
/bulk/{prefecture_code} の Parquet は、オープンデータの列（英語名）に、詳細ページから読み取った列と指標の列を付けた1行1（事業所番号, サービス）の表です。
詳細ページの列は、施設系のサービスの行だけに入ります。