API の使い方 — 介護施設・事業所の比較

Name: API の使い方 — 介護施設・事業所の比較
Creator: tokeilab
License: https://creativecommons.org/licenses/by/4.0/

全国の介護施設・事業所の比較表を JSON で取得できます。ベース URL は https://api.tokeilab.org、機械可読の一覧は openapi.json、項目の意味はデータ仕様にあります。

使い方の例

市区町村とサービスから比べる: GET /api/v1/kaigo/municipality/131130/510?sort=cost（渋谷区の特養を費用の目安が安い順に100件ずつ）。市区町村コードは /kaigo/municipalities.json で探せます。
地点の近くで探す: GET /api/v1/kaigo/near?lat=35.6586&lon=139.7454&r=2000&service=510（半径 r m 以内、近い順に最大50件）。
1件の全項目: GET /api/v1/kaigo/facility/0170103865。

人が使う場合は市区町村から探すページで同じことができます。

エンドポイント	内容	cost_units
`GET /api/v1/kaigo/facility/{facility_id}` 例: `/api/v1/kaigo/facility/0170103865`	事業所1件の全項目: サービスごとの費用の目安・職員の手厚さ・定員と利用者・居室・設立年、運営法人と同じ法人の事業所数	1
`GET /api/v1/kaigo/municipality/{municipality_code}/{service_code}` 例: `/api/v1/kaigo/municipality/131130/510?sort=cost`	市区町村×サービス種別の比較表（100件ずつ。sort= id・cost・staff・opened）	1
`GET /api/v1/kaigo/near` 例: `/api/v1/kaigo/near?lat=35.6586&lon=139.7454&r=2000&service=510`	1地点の周り: 半径 r m 以内（最大3000 m）の事業所を近い順に最大50件。service= でサービス種別を絞れる	2
`GET /api/v1/kaigo/bulk/{prefecture_code}` 例: `/api/v1/kaigo/bulk/13`	都道府県全体の一覧 Parquet への署名付き URL（1時間有効）	10

facility_id: 10桁の事業所番号。municipality_code: 6桁の市区町村コード。prefecture_code: 01〜47。
service_code: 3桁のサービス番号（510 特養、520 老健、540 小規模特養、550 介護医療院、331 介護付き有料老人ホーム、320 グループホーム、150 デイサービスなど。一覧は計算方法と各市区町村ページ）。
sort: id 事業所番号順（既定）・cost 費用の目安が安い順・staff 職員が手厚い順・opened 設立が古い順（不明は最後）。page: 1 から（100件ずつ）。
lat 20〜46、lon 122〜154（世界測地系の度）。r 1〜3000 m（省略時 1000）。

API キーは不要です。IP アドレスごとに毎分 20 回まで使えます（回数は Cloudflare の拠点ごとに数える目安です）。
課金はまだ有効化していません。すべての呼び出しをコスト単位（cost_units）で計測しています。料金は料金を参照。
データのライセンスは CC BY 4.0 です。利用時は「厚生労働省介護サービス情報公表システムから抽出したデータを tokeilab が加工して作成」の表示をお願いします。

エラーは RFC 9457 の application/problem+json で返します。種類はエラーの種類を参照。