自治体スマエネ補助金データAPI サービスFAQ
📋 基本情報
🔍 このAPIサービスとは?
「自治体スマエネ補助金データAPIサービス」は、国際航業が提供する全国の地方自治体の創・蓄・省エネ関連の補助金データベースを参照できるREST APIサービスです。約2,000件に及ぶ補助金情報を効率的に活用し、太陽光・蓄電池・EV・V2Hメーカー、商社、電力・ガス会社等の業務システムやWebサイトに補助金参照機能を簡単に統合することができます。
📅 いつから提供されていますか?
2025年3月4日より提供開始されました。
💰 料金体系はどうなっていますか?
有償API: 初期費用0円・月額費用10万円~30万円(※想定トラフィック数による個別見積)
有償Excelデータ: 初期費用0円・月額費用50万円
🔧 技術仕様
🌐 APIの種類は何ですか?
REST (Representational State Transfer) APIで提供されています。
🔄 更新頻度はどのくらいですか?
補助金データは月1回更新(3~6月の高頻度更新時はベストエフォートとなるが月2回以上の更新をするケースもあり。個別見積で高頻度対応のAPI提供も可能)。
📦 対象データはどのようなものですか?
対象: 国・都道府県・市区町村の補助金(約2,000件)
設備カテゴリー: 家庭向け・事業者向け両方に対応
太陽光発電
蓄電池
高効率給湯機(自然冷媒ヒートポンプ給湯機など)
充電設備(普通・急速充電器/V2X)
次世代自動車関連(EV・PHVなど)
次世代住宅・建築(ZEH・ZEH-M・LCCM・独自基準・ZEB)
断熱・窓改修
省エネ家電(LED照明・エアコン)
EMS
燃料電池
木質バイオマス
事業者向け再エネ関連設備など多岐にわたる
💻 API仕様詳細
📝 リクエスト方法はどうなっていますか?
補助金情報取得は以下のGETリクエストで行います:
GET /sys/subsidy/{?prefecture_cd,city,faclity_cd}
🔎 検索条件はどのように指定できますか?
prefecture_cd: 都道府県コード(00~48)
city: 市区町村の文字列
faclity_cd: 対象設備コード
これらのパラメーターは同時指定が可能で、複合条件での絞り込み検索ができます。パラメーターを指定しない場合は全データを取得します。
📊 レスポンス形式は何ですか?
JSONフォーマットで返されます。主なレスポンス項目:
id: 補助金ID
area: 地域区分
title: 補助タイトル
url: 問い合わせ先URL
city: 市区町村(県含む)
class: 補助区分
facility: 対象設備
country_facility: 国の対象設備(詳細説明)
overview: 補助金概要
phone: 問い合わせ先電話番号
prefecture: 都道府県
price: 補助額上限
rep: 問い合わせ先部署
del_flg: 補助金募集状況
modified_id: 最終更新者
modified: 最終更新日時
created_id: 作成者
created: 作成日時
🌟 リクエスト例
GET https://api.enegaeru.com/sys/sys/subsidy/?prefecture_cd=13&city=江東区&faclity_cd=[`01`, `02`]
🚀 想定ユースケース
💼 どのような業種が利用できますか?
太陽光・蓄電池販売企業
電力・ガス会社
エネルギー関連メーカー
商社
地方自治体や官公庁との連携
📱 具体的な活用例は?
見積りシステムの連携:
太陽光・蓄電池販売企業が自社の見積りシステムに補助金情報を組み込み、提案力を強化
Webサイトでのシミュレーション提供:
電力・ガス会社が顧客向けWebサイトで補助金シミュレーションを提供し、付加価値を向上
補助金活用促進支援:
地方自治体や官公庁との連携により補助金活用促進を支援
販売システムとの統合:
太陽光・蓄電池・EV販売システムに統合し、具体的な補助金情報を含めた提案が可能に
📈 メリットと今後の展開
🎯 導入のメリットは?
工数削減と開発効率化: 自社Web等にスマエネ補助金データ参照機能を簡単にAPIで実装できる
顧客サービス向上: 補助金を利用したい需要家が補助金を探しやすくなり付加価値が向上
競合優位性の向上: 顧客への補助金参照機能の提供による競合にはできないWebサービスの提供
🔮 今後の展開予定は?
2025年度内に以下の展開を予定しています:
補助金申請代行BPOへの拡張: 補助金申請プロセスのBPO化を視野に入れたサービス開発
データの強化: 各設備の購入金額へ補助金を加味した自動計算ができるデータとロジックへ拡張
再エネ導入促進APIへの統合: 住宅用・産業用の太陽光・蓄電池経済効果試算APIとの統合
🔌 技術解説と実装ガイド
🛠️ RESTAPIの基本的解説
RESTful APIは、HTTPプロトコルを使用してリソースにアクセスする方法を提供するWebサービスの設計アーキテクチャです。
特徴:
ステートレス: 各リクエストは独立しており、前のリクエストの状態に依存しない
キャッシュ可能: レスポンスはキャッシュできるよう明示的に設計される
統一インターフェース: リソースに対する操作が統一されている (GET, POST, PUT, DELETEなど)
レイヤード構造: クライアントはサーバーの内部アーキテクチャを知る必要がない
📝 実装手順例 (以下コードはあくまでもイメージです)
APIキーの取得:
国際航業に問い合わせ、APIキーを取得
基本的な実装:
// 例: JavaScriptでの実装
async function getSubsidyData(prefectureCode, city, facilityCodes) {
try {
// パラメータの構築
const params = new URLSearchParams();
if (prefectureCode) params.append('prefecture_cd', prefectureCode);
if (city) params.append('city', city);
if (facilityCodes && facilityCodes.length > 0) params.append('faclity_cd', JSON.stringify(facilityCodes));
// APIリクエスト
const response = await fetch(`https://api.enegaeru.com/sys/sys/subsidy/?${params}`, {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
});
// レスポンス処理
if (!response.ok) {
throw new Error(`API error: ${response.status}`);
}
const data = await response.json();
return data;
} catch (error) {
console.error('補助金データ取得エラー:', error);
throw error;
}Webアプリケーションへの統合例:
// 例: 太陽光・蓄電池の設備選択に基づいて補助金検索
document.getElementById('search-button').addEventListener('click', async () => {
const prefecture = document.getElementById('prefecture-select').value;
const city = document.getElementById('city-input').value;
// 選択された設備のコードを取得
const selectedFacilities = [];
if (document.getElementById('solar-checkbox').checked) selectedFacilities.push('01');
if (document.getElementById('battery-checkbox').checked) selectedFacilities.push('02');
try {
// APIからデータ取得
const subsidies = await getSubsidyData(prefecture, city, selectedFacilities);
// 結果を表示
displaySubsidies(subsidies);
} catch (error) {
showErrorMessage('補助金情報の取得に失敗しました。');
}
});
// 補助金情報の表示関数
function displaySubsidies(subsidies) {
const container = document.getElementById('results-container');
container.innerHTML = '';
if (subsidies.length === 0) {
container.innerHTML = '<p>該当する補助金はありません。</p>';
return;
}
subsidies.forEach(subsidy => {
const card = document.createElement('div');
card.className = 'subsidy-card';
card.innerHTML = `
<h3>${subsidy.title}</h3>
<p><strong>地域:</strong> ${subsidy.prefecture} ${subsidy.city}</p>
<p><strong>対象設備:</strong> ${subsidy.facility.join(', ')}</p>
<p><strong>補助額上限:</strong> ${subsidy.price}</p>
<p>${subsidy.overview}</p>
<a href="${subsidy.url}" target="_blank">詳細情報</a>
`;
container.appendChild(card);
});
}
🔄 他のシステムとの連携例
CRMシステムとの連携:
// 顧客データに基づいて適切な補助金を表示
async function showRelevantSubsidies(customerData) {
const prefecture = customerData.address.prefecture;
const city = customerData.address.city;
const interestedFacilities = customerData.interests.map(interest => {
// 関心のある設備をAPIの設備コードに変換
switch(interest) {
case '太陽光': return '01';
case '蓄電池': return '02';
case 'EV': return '05';
default: return null;
}
}).filter(code => code !== null);
const subsidies = await getSubsidyData(
getPrefectureCode(prefecture),
city,
interestedFacilities
);
return subsidies;
}見積りシステムへの組み込み:
// 見積りの際に利用可能な補助金を自動的に適用
async function calculateQuoteWithSubsidies(quoteData) {
const prefecture = quoteData.customer.prefecture;
const city = quoteData.customer.city;
// 見積り内の設備に基づいて設備コードを設定
const facilityCodes = [];
if (quoteData.items.includes('solar_panel')) facilityCodes.push('01');
if (quoteData.items.includes('battery')) facilityCodes.push('02');
if (quoteData.items.includes('heat_pump')) facilityCodes.push('03');
// 該当する補助金を取得
const subsidies = await getSubsidyData(
getPrefectureCode(prefecture),
city,
facilityCodes
);
// 見積りに補助金情報を追加
const totalSubsidyAmount = calculateApplicableSubsidies(quoteData, subsidies);
return {
...quoteData,
subsidies: subsidies,
subsidyAmount: totalSubsidyAmount,
finalPrice: quoteData.totalPrice - totalSubsidyAmount
};
}
📞 お問い合わせ先
お問い合わせフォーム: https://form.run/@contact-enegaeru
E-Mail: info@enegaeru.com
TEL: 070-3669-8761 (担当:樋口)
📚 関連サービス
エネがえるAPI(カスタマイズ・Web組み込み可能なAPI): https://www-v4.enegaeru.com/apidoc/api-general.html
エネがえるASP(住宅用太陽光・蓄電池提案用): https://www.enegaeru.com/
エネがえるBiz(産業用自家消費型太陽光・蓄電池提案用): https://biz.enegaeru.com/
エネがえるEV・V2H(EV・V2H提案用): http://evv2h.enegaeru.com/