Zum Inhalt springen
POST AI agent ready /v1/carbon/estimate

Carbon Estimate API – CO2 pro Seitenaufruf über Green Web Foundation

Ruft eine URL ab und schätzt den Kohlendioxidausstoß pro Seitenaufruf basierend auf den übertragenen Bytes. Verwendet die Methodik des nachhaltigen Webdesigns mit konfigurierbaren Energie- und Kohlenstoffintensitätsfaktoren. Gibt CO2 in Gramm, Energie in kWh, eine prozentuale Rangfolge gegenüber der mittleren Webseitengröße und die bei der Berechnung verwendeten Methodenkonstanten zurück.

Parameters

stringrequired

URL to estimate carbon emissions for.

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

Website-Nachhaltigkeitsberichterstattung

Erstellen Sie CO2-Schätzungen für jede Seite Ihrer Website. Fassen Sie die Ergebnisse in einem Nachhaltigkeitsbericht zusammen, der den gesamten geschätzten CO2-Ausstoß pro Monat basierend auf Ihrem Verkehrsaufkommen zeigt. Teilen Sie den Bericht mit Stakeholdern oder veröffentlichen Sie ihn auf Ihrer Website.

Grüne Webabzeichen

Rufen Sie diesen Endpunkt auf und zeigen Sie den Wert „cleaner_than_percent“ als Abzeichen in der Fußzeile Ihrer Website an. „Diese Seite ist sauberer als 89 % der getesteten Webseiten.“ Fördert die Leistungsoptimierung und schafft Vertrauen bei umweltbewussten Benutzern.

Verfolgung des CO2-Budgets in CI

Fügen Sie einen CI-Schritt hinzu, der diesen Endpunkt aufruft, nachdem Sie Ihre Site erstellt haben. Der Build schlägt fehl, wenn der CO2-Ausstoß pro Seitenaufruf einen Schwellenwert überschreitet (z. B. 0,5 g). Verfolgen Sie das CO2-Budget im Laufe der Zeit sowie Paketgröße und Leistungskennzahlen.

Frequently asked questions

Wie genau ist die Kohlenstoffschätzung?
Die Schätzung basiert auf der Seitenübertragungsgröße und der Sustainable Web Design-Methodik. Es liefert eine Richtungsschätzung, keine genaue Messung. Die tatsächlichen Emissionen hängen vom Gerät des Besuchers, dem Netzwerk und dem Energiemix des Rechenzentrums ab, das die Seite bedient.
Was bedeutet „cleaner_than_percent“?
Dies ist der Prozentsatz der Webseiten, die mehr Bytes übertragen als die getestete URL. Eine Punktzahl von 89 bedeutet, dass die Seite weniger Bytes als 89 % der mittleren Stichprobe überträgt. Höher ist besser.
Berücksichtigt dies Bilder und Skripte von Drittanbietern?
Die Schätzung basiert nur auf der anfänglichen HTML-Antwortgröße. Es werden keine Bilder, CSS, JavaScript oder Ressourcen von Drittanbietern geladen. Für eine Schätzung der gesamten Seite kombinieren Sie es mit einem Tool, das das Gesamtseitengewicht misst.
Welche Methodik wird verwendet?
Die Berechnung folgt dem Sustainable Web Design Model, das die Energie pro übertragenem Gigabyte schätzt und einen globalen durchschnittlichen Kohlenstoffintensitätsfaktor anwendet. Aus Gründen der Transparenz sind die Methodikkonstanten in jeder Antwort enthalten.
Kann ich den Kohlenstoffintensitätsfaktor anpassen?
Nicht über diesen Endpunkt. Die Kohlenstoffintensität basiert auf einem globalen Durchschnitt. Wenn Sie den Energiemix Ihres Hosting-Anbieters kennen, können Sie Ihren eigenen Faktor auf den in der Antwort zurückgegebenen Wert „energy_kwh“ anwenden.

Get your API key

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

Sign up free View full docs