MindCity AI Discovery API

公開可能と判定した事業者・施設情報を検索し、公式サイトと根拠へ到達するための読み取り専用APIです。回答の生成や比較は、利用するAI Agentが行います。

Read-only public entity discovery. Use structured filters, fetch the returned entity ID, then cite its canonical page and sources. No LLM calls are made by this API.

使い方

OpenAPI仕様をHTTP対応Agentに読み込ませます。
カテゴリ一覧から検索するカテゴリIDを選びます。
都道府県・カテゴリで検索し、必要なら名称や住所の一部をqに指定します。
返却されたidで詳細を取得し、official_urlとsourcesを確認します。

GET https://mindcity.org/api/v1/categories
GET https://mindcity.org/api/v1/search?category=hospital&region=%E5%8C%97%E6%B5%B7%E9%81%93&limit=5
GET https://mindcity.org/api/v1/entities/{検索結果のid}

検索条件：q、category、region、city、limit（1〜50、標準20）、cursor。qは名称・住所の部分一致です。自然文の意味検索やサービス説明全文検索ではありません。地域名は保存値に完全一致し、区名等の表記差にはqを併用してください。

結果はID昇順です。次ページは同じ条件にnext_cursorをcursorとして追加します。固定スナップショットではないため、更新や公開停止により結果は変化します。未知の条件や同一パラメータの重複は400です。

情報の読み方

idは文字列、categoryはIDと名称、canonical_urlは既存の/profile/{id}/です。組織と拠点の区別が未正規化のためtypeはentityです。nullは不明を意味し、存在しないとの断定には使えません。座標0,0・範囲外・欠損はgeo=nullです。座標と住所の一致は未保証です。

日時の時差が確定できない既存値はlast_verified_at/updated_atに推測でUTCを付けずnullを返し、data_quality.legacy_timestampsに元の値を示します。sourcesのrecord_evidenceは保存された確認履歴で、現在の各値との完全一致を保証しません。official_destinationは公式サイトへの導線です。

営業時間、現在営業中、料金、在庫、予約枠、求人案件は提供対象外です。不明な情報は推測せず、公式サイトで確認するよう案内してください。根拠や公式URLの存在は包括的な転載・再配布許諾を意味しません。

利用上限とエラー

試験公開は認証不要です。3つのAPI合計で接続元IPごとに60リクエスト/分。429/503の場合はRetry-Afterの秒数を待ってください。非公開・保留・closed・対象外・存在しないIDは404となり、区別して開示しません。GET/HEAD以外は405です。

公開状態を再確認するため、この段階のEntity応答はno-storeです。大量取得や高負荷利用を前提にしたサービスではありません。OpenAPIを公開するだけで各AIサービスへ自動登録されるわけではなく、HTTP取得機能での明示設定が必要です。