POST AI agent ready /v1/carbon/estimate

Carbon Estimate API - Green Web Foundation 経由のページビューあたりの CO2

URL を取得し、転送されたバイト数に基づいてページビューごとの二酸化炭素排出量を推定します。構成可能なエネルギーおよび炭素強度係数を備えた持続可能な Web デザイン手法を使用します。 CO2 をグラム単位で、エネルギーを kWh 単位で、Web ページサイズの中央値に対するパーセンタイルランキング、および計算に使用された方法定数を返します。

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/carbon/estimate \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.wikipedia.org"}'

When to use this API

ウェブサイトの持続可能性レポート

サイト上のすべてのページの炭素推定値を生成します。結果をサステナビリティレポートに集約し、交通量に基づいた月ごとの推定総 CO2 量を示します。レポートを関係者と共有するか、サイトに公開します。

緑色のウェブバッジ

このエンドポイントを呼び出して、Web サイトのフッターに Cleaner_than_percent 値をバッジとして表示します。「このページは、テストされた Web ページの 89% よりもきれいです。」パフォーマンスの最適化を促進し、環境に配慮したユーザーとの信頼を構築します。

CI での炭素収支の追跡

サイトの構築後に、このエンドポイントを呼び出す CI ステップを追加します。ページビューあたりの CO2 がしきい値 (0.5g など) を超える場合、ビルドは失敗します。バンドルのサイズとパフォーマンスの指標とともに、炭素予算を長期にわたって追跡します。

Frequently asked questions

炭素推定値はどの程度正確ですか?

この見積もりは、ページ転送サイズと持続可能な Web デザイン方法論に基づいています。正確な測定ではなく、方向の推定を提供します。実際の排出量は、訪問者のデバイス、ネットワーク、およびページを提供するデータセンターのエネルギー構成によって異なります。

Cleaner_than_percent とはどういう意味ですか?

これは、テストされた URL よりも多くのバイトを転送した Web ページの割合です。スコア 89 は、ページが転送するバイト数がサンプルの中央値の 89% より少ないことを意味します。高いほど良いです。

これは画像とサードパーティのスクリプトを考慮していますか?

見積もりは、最初の HTML 応答サイズのみに基づいています。画像、CSS、JavaScript、サードパーティのリソースは読み込まれません。ページ全体の見積もりを得るには、総ページ重量を測定するツールと組み合わせてください。

どのような方法論が使用されていますか?

計算は持続可能な Web デザインモデルに従い、転送される 1 ギガバイトあたりのエネルギーを推定し、世界平均の炭素強度係数を適用します。方法論の定数は、透明性を確保するためにすべての応答に含まれます。

炭素強度係数をカスタマイズできますか?

このエンドポイント経由ではありません。炭素強度は世界平均を使用します。ホスティングプロバイダーのエネルギー構成がわかっている場合は、応答で返されるenergy_kwh 値に独自の係数を適用できます。

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.