全国医療機関マップの検索APIの仕様です。全国の薬局・医科・歯科医療機関（224,540件）の基本情報を、プログラムから取得できます。機械可読な仕様は OpenAPI 3.1 仕様（openapi.json） にあります。AIエージェント向けの案内は llms.txt にあります。
| ベースURL | https://agentzukan.com |
|---|---|
| 認証 | 不要（公開API） |
| 形式 | GET、レスポンスは JSON（UTF-8） |
| キャッシュ | 各エンドポイントは Cache-Control ヘッダーでキャッシュ可能時間（5分〜1時間）を返します。繰り返し取得する場合はキャッシュの活用をお願いします |
| レート制限 | 明示的な上限は設けていませんが、常識的な頻度での利用をお願いします。短時間に大量のリクエストが集中した場合は、応答を制限することがあります |
キーワード（施設名または住所への部分一致）、都道府県、種別で全国を横断検索します。q と pref の少なくとも一方が必要です。
q | 検索キーワード。施設名・住所に対する部分一致（大文字小文字を区別しません） |
|---|---|
pref | 都道府県名（例: 東京都） |
type | 種別。薬局 / 医科 / 歯科 のいずれか |
limit | 最大取得件数（初期値 50、上限 200） |
open_now | 1 を指定すると、現在時刻（日本時間）に診療中の施設だけを返します。診療時間データがある医科・歯科の施設が対象です |
day / time | 曜日（mon〜sun、祝日は hol）と時刻（HH:MM）を指定すると、その曜日・時刻に診療中の施設だけを返します。date（YYYY-MM-DD）で日付から曜日を決めることもできます（祝日判定はしません） |
curl "https://agentzukan.com/api/search?q=%E6%B5%9C%E7%94%B0%E7%97%85%E9%99%A2"{
"count": 1,
"results": [
{
"code": "1310110049",
"type": "医科",
"name": "医療法人財団 小畑会 浜田病院",
"postal_code": "101-0062",
"prefecture": "東京都",
"address": "千代田区神田駿河台二丁目５番地",
"tel": "03-5280-1166",
"lat": 35.700068,
"lng": 139.762011,
"precision": "町字"
}
]
}診療中の条件を指定した場合、レスポンスには判定に使った曜日・時刻（open_at）が含まれます。各結果の hours には曜日別の診療時間（施設が診療時間を公表している場合）が入ります。
curl "https://agentzukan.com/api/search?q=%E5%B0%8F%E5%85%90%E7%A7%91&pref=%E6%9D%B1%E4%BA%AC%E9%83%BD&day=sun&time=10:00"パラメータ不足の場合は 400 で {"error":"q or pref is required"} を返します。
緯度経度の矩形範囲内にある施設を返します。地図の表示範囲に合わせた取得を想定しています。
bbox（必須） | 範囲を「最小経度,最小緯度,最大経度,最大緯度」の形式で指定（例: 139.74,35.68,139.79,35.72） |
|---|---|
type | 種別。薬局 / 医科 / 歯科 のいずれか |
limit | 最大取得件数（初期値 3000、上限 5000） |
open_now / day / time | /api/search と同じ指定で、その曜日・時刻に診療中の施設だけに絞れます |
curl "https://agentzukan.com/api/facilities?bbox=139.74,35.68,139.79,35.72&type=%E8%96%AC%E5%B1%80"{
"count": 2,
"truncated": false,
"results": [
{
"code": "…（10桁の医療機関コード）",
"type": "薬局",
"name": "…",
"address": "…",
"tel": "…",
"lat": 35.69,
"lng": 139.76,
"precision": "…"
}
]
}truncated が true の場合、結果が limit に達して切り捨てられています。範囲を狭めるか limit を増やしてください。bbox が不正な場合は 400 を返します。
10桁の医療機関コードを指定して、施設の全項目を1件返します。検索結果の address は都道府県を除く住所（市区町村名から）です。
code（必須） | 医療機関コード（10桁の数字） |
|---|
curl "https://agentzukan.com/api/facility?code=1310110049"{
"code": "1310110049",
"type": "医科",
"name": "医療法人財団 小畑会 浜田病院",
"postal_code": "101-0062",
"prefecture": "東京都",
"city": "千代田区",
"address": "千代田区神田駿河台二丁目５番地",
"tel": "03-5280-1166",
"founder": "医療法人財団 小畑会 理事長 中川 菜実",
"manager": "中川 菜実",
"designated_date": "1957-11-01",
"renewed_date": "2023-11-01",
"status": "現存",
"departments": "産 婦 小 内 外 放 耳い 眼 皮 形外 美外",
"facility_kind": "病院",
"beds_raw": "一般 22",
"bureau": "関東信越厚生局",
"snapshot_date": "2026-10-01",
"lat": 35.700068,
"lng": 139.762011,
"precision": "町字",
"specialties": ["内科", "外科", "婦人科", "小児科", "形成外科", "放射線科", "産科", "皮膚科", "眼科", "美容外科", "耳鼻咽喉科"]
}診療時間データがある施設では、曜日別の診療時間 hours（mon〜sun、祝日は hol、各曜日は ["開始","終了"] の配列）と、その出典時点 hours_snapshot が付きます。ない施設では null です。
code が10桁の数字でない場合は 400、該当する施設がない場合は 404 を返します。specialties は診療科名を標準化した表示名の一覧で、医科・歯科の施設にのみ付きます（公表データに診療科がない施設では null になります）。
hours フィールド。施設全体の診療時間で、診療科別の時間とは異なる場合があります）。施設からの報告に基づく公表データのため、実際の診療時間・休診日・受付状況とは異なる場合があります。受診前には各施設へ直接確認してください。内容の正確性・完全性を保証するものではありません。