Ir al contenido
POST AI agent ready /v1/carbon/estimate

API de estimación de carbono: CO2 por vista de página a través de Green Web Foundation

Obtiene una URL y estima las emisiones de dióxido de carbono por página vista en función de los bytes transferidos. Utiliza la metodología de Diseño Web Sostenible con factores de intensidad de energía y carbono configurables. Devuelve CO2 en gramos, energía en kWh, una clasificación percentil respecto al tamaño medio de una página web y las constantes metodológicas utilizadas en el cálculo.

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

Informes de sostenibilidad del sitio web

Genere estimaciones de carbono para cada página de su sitio. Agregue los resultados en un informe de sostenibilidad que muestre el CO2 total estimado por mes en función de su volumen de tráfico. Comparta el informe con las partes interesadas o publíquelo en su sitio.

Insignias web verdes

Llame a este punto final y muestre el valor de porcentaje_más limpio como una insignia en el pie de página de su sitio web. "Esta página está más limpia que el 89% de las páginas web analizadas". Fomenta la optimización del rendimiento y genera confianza entre los usuarios conscientes del medio ambiente.

Seguimiento del presupuesto de carbono en CI

Agregue un paso de CI que llame a este punto final después de crear su sitio. Falla la compilación si el CO2 por vista de página excede un umbral (por ejemplo, 0,5 g). Realice un seguimiento del presupuesto de carbono a lo largo del tiempo junto con el tamaño del paquete y las métricas de rendimiento.

Frequently asked questions

¿Qué tan precisa es la estimación de carbono?
La estimación se basa en el tamaño de transferencia de la página y la metodología de Diseño Web Sostenible. Proporciona una estimación direccional, no una medición precisa. Las emisiones reales dependen del dispositivo del visitante, la red y la combinación de energía del centro de datos que atiende a la página.
¿Qué significa más limpio que el porcentaje?
Este es el porcentaje de páginas web que transfieren más bytes que la URL probada. Una puntuación de 89 significa que la página transfiere menos bytes que el 89 % de la muestra mediana. Cuanto más alto es mejor.
¿Esto tiene en cuenta imágenes y scripts de terceros?
La estimación se basa únicamente en el tamaño de la respuesta HTML inicial. No carga imágenes, CSS, JavaScript ni recursos de terceros. Para obtener una estimación de página completa, combínela con una herramienta que mida el peso total de la página.
¿Qué metodología se utiliza?
El cálculo sigue el Modelo de Diseño Web Sostenible, que estima la energía por gigabyte transferido y aplica un factor de intensidad de carbono promedio global. Las constantes de la metodología se incluyen en cada respuesta para mayor transparencia.
¿Puedo personalizar el factor de intensidad de carbono?
No a través de este punto final. La intensidad de carbono utiliza un promedio global. Si conoce la combinación energética de su proveedor de alojamiento, puede aplicar su propio factor al valor de energía_kwh devuelto en la respuesta.

Get your API key

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