メインコンテンツにスキップ

【API】自治体スマエネ補助金データAPIサービスとは?

補助金データを参照するAPIの対象・認証・検索条件・ページングを解説します。現行共通公開仕様と、別途確認が必要な件数・料金・提供条件を分けて案内します。

対応者:樋口 悟

自治体スマエネ補助金データAPI サービスFAQ

📋 基本情報

🔍 このAPIサービスとは?

「自治体スマエネ補助金データAPIサービス」は、国際航業が提供する創・蓄・省エネ関連の補助金データベースを参照できるREST APIサービスです。太陽光・蓄電池・EV・V2Hメーカー、商社、電力・ガス会社等のシステムやWebサイトへ参照機能を組み込む用途を想定しています。旧本文には約5,000件と約2,000件が併記されていましたが、基準日・集計単位を今回確認できていません。最新の収録範囲・件数は対象契約とデータの基準日を確認してください。

📅 いつから提供されていますか?

2025年3月4日より提供開始されました。

💰 料金体系はどうなっていますか?

以下は従来掲載の料金案内です。今回の技術仕様監査では現行料金・税区分・契約範囲を再確認していません。発注判断の前に、現在の正式見積と提供条件を確認してください。

  • 有償API: 初期費用0円・月額費用30万円(年間360万円) 税別

  • 有償Excelデータ: 初期費用0円・月額費用50万円(年間600万円) 税別
    ※それぞれ最低12ヶ月契約

🔧 技術仕様

🌐 APIの種類は何ですか?

REST (Representational State Transfer) APIで提供されています。

🔄 更新頻度はどのくらいですか?

補助金データは月1回程度で更新。

📦 対象データはどのようなものですか?

  • 対象:国・都道府県・市区町村の補助金。収録範囲と件数はデータ基準日・集計単位により確認してください。検索結果は現在の受付や申請適合を保証しません。

  • 設備カテゴリー: 家庭向け・事業者向け両方に対応

    • 太陽光発電

    • 蓄電池

    • 高効率給湯機(自然冷媒ヒートポンプ給湯機など)

    • 充電設備(普通・急速充電器/V2X)

    • 次世代自動車関連(EV・PHVなど)

    • 次世代住宅・建築(ZEH・ZEH-M・LCCM・独自基準・ZEB)

    • 断熱・窓改修

    • 省エネ家電(LED照明・エアコン)

    • EMS

    • 燃料電池

    • 木質バイオマス

    • 事業者向け再エネ関連設備など多岐にわたる

API仕様詳細(現行の共通公開API)

以下は「エネがえる共通 公開用 API」の公開定義を対象としています。2026年10月10日確認、OpenAPI 3.0.0、仕様書内バージョン1.0.0です。APIの実行には対象機能の契約・権限が必要です。旧API・個別契約APIの仕様へ一律に適用しないでください。
​

接続先と認証

本番ベースURLは https://api.enegaeru.com です。POST /sys/login の応答で取得した uid を Authorization ヘッダーへ直接設定し、x-api-key も送ります。Bearer は付けません。認証情報はサーバー側で管理してください。
​

一覧の取得:GET /sys/subsidy

主な検索条件は次のとおりです。
・prefecture_cd:00は国、01~47は都道府県、48は都道府県による絞り込みなし。
・city:市区町村名の完全一致。
・facility_cd:対象設備コード。01は太陽光発電、02は蓄電システム。複数指定が可能です。
・target_class:個人・事業・共通。個人を指定すると個人または共通を含むデータ、事業を指定すると事業または共通を含むデータが対象です。
・limit:1ページの取得件数。1~2500、未指定時は200です。
・nextToken:続きのページを取得するときに、直前の応答で返された値を指定します。

検索条件を指定しない場合は全データが検索対象になりますが、1回で全件を取得するという意味ではありません。

一覧の応答は配列そのものではなく、items、total、nextToken を持つJSONオブジェクトです。items が今回取得した補助金一覧、total が条件に一致する総件数です。nextToken が返った場合は、同じ検索条件にその値を加えて次ページを取得し、続きがなくなるまで処理します。nextToken はサーバーの応答値をそのまま使用し、推測して作らないでください。

詳細の取得:GET /sys/subsidy/{id}

一覧で取得した id を使って詳細を取得します。一覧に含まれない補助額や問い合わせ先等の詳細項目は、こちらの応答スキーマを確認してください。一覧の items に詳細項目がすべて含まれる前提で実装しないでください。

検索画面向け:GET /sys/subsidy-search

サーバー側の検索・並べ替え・ページ番号指定に対応します。一覧APIとはパラメータと検索の意味が異なります。
・対象設備は facility_label(ラベル文字列)を指定します。
・都道府県名 prefecture は scope=prefecture のときに指定します。
・ページングは page と per_page です。per_page は1~500、未指定時50です。
・target_class は完全一致です。個人を指定しても共通は含みません。
一覧APIの facility_cd、nextToken や補助対象の包含ルールを、そのまま検索APIへ流用しないでください。

リクエストの最小例

東京都江東区の太陽光・蓄電池に関する個人向けデータを取得する形の例です。応答では共通向けデータも対象に含まれます。

取得済みuidとAPIキーをサーバー側の環境変数へ設定した場合の1行コマンド例です。今回、認証付きAPIは実行していません。

curl --fail-with-body --get 'https://api.enegaeru.com/sys/subsidy' -H "x-api-key: ${ENEGAERU_API_KEY}" -H "Authorization: ${ENEGAERU_UID}" --data-urlencode 'prefecture_cd=13' --data-urlencode 'city=江東区' --data-urlencode 'facility_cd=01' --data-urlencode 'facility_cd=02' --data-urlencode 'target_class=個人' --data-urlencode 'limit=20'

エラーと取り込み時の注意

補助金一覧の個別定義では、400は入力不正、401は未ログイン・トークン不正、500は内部エラーです。詳細APIの404は該当データなしです。共通エラーには403も定義されているため、対象操作と応答本文を合わせて確認してください。エラー本文は text/plain の場合があります。

表示するときは、補助金タイトル等の文字列をHTMLへ直接連結せず、文字列として安全に表示してください。詳細情報や制度の公式募集要項で募集期間、予算、対象者、対象設備、併用条件等を確認してください。検索結果に出たことだけでは、申請資格、採択、補助額は確定しません。見積額へ自動で差し引く処理を、取得APIの標準機能として扱わないでください。

🚀 想定ユースケース

💼 どのような業種が利用できますか?

  • 太陽光・蓄電池販売企業

  • 電力・ガス会社

  • エネルギー関連メーカー

  • 商社

  • 地方自治体や官公庁との連携

📱 具体的な活用例は?

  1. 見積りシステムの連携:

    • 太陽光・蓄電池販売企業が自社の見積りシステムに補助金情報を組み込み、提案力を強化

  2. Webサイトでのシミュレーション提供:

    • 電力・ガス会社が顧客向けWebサイトで補助金シミュレーションを提供し、付加価値を向上

  3. 補助金活用促進支援:

    • 地方自治体や官公庁との連携により補助金活用促進を支援

  4. 販売システムとの統合:

    • 太陽光・蓄電池・EV販売システムに統合し、具体的な補助金情報を含めた提案が可能に

📈 メリットと今後の展開

🎯 導入のメリットは?

  1. 工数削減と開発効率化: 自社Web等にスマエネ補助金データ参照機能を簡単にAPIで実装できる

  2. 顧客サービス向上: 補助金を利用したい需要家が補助金を探しやすくなり付加価値が向上

  3. 競合優位性の向上: 顧客への補助金参照機能の提供による競合にはできないWebサービスの提供

🔮 今後の展開予定は?

以下は2025年度内の展開として記載されていた構想です。現在の提供開始・実装状況は今回未確認のため、提供中の機能や納期の約束とは扱わず、個別に確認してください。

  1. 補助金申請代行BPOへの拡張: 補助金申請プロセスのBPO化を視野に入れたサービス開発

  2. データの強化: 各設備の購入金額へ補助金を加味した自動計算ができるデータとロジックへ拡張

  3. 再エネ導入促進APIへの統合: 住宅用・産業用の太陽光・蓄電池経済効果試算APIとの統合

実装は上記の現行共通API仕様詳細を参照してください。旧記載の重複パス、誤った認証・パラメータ例、配列前提の応答処理は使用しないでください。

📞 お問い合わせ先

📚 関連サービス

こちらの回答で解決しましたか?