Building a Carbon Footprint Tracker with Environmental Data APIs

#python #tutorial #webdev #programming

Climate change awareness is driving demand for carbon footprint tracking tools. By combining environmental data APIs with Python, you can build a tracker that calculates and monitors carbon emissions from various activities.

Why Build a Carbon Footprint Tracker?

Help individuals understand their environmental impact
Enable businesses to report sustainability metrics
Track emission reductions over time
Integrate with ESG reporting frameworks

Setting Up

pip install requests pandas

Using the Carbon Interface API

import requests

API_KEY = "YOUR_CARBON_INTERFACE_KEY"
BASE_URL = "https://www.carboninterface.com/api/v1"

def calculate_flight_emissions(passengers, legs):
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    payload = {
        "type": "flight",
        "passengers": passengers,
        "legs": legs
    }
    response = requests.post(f"{BASE_URL}/estimates", json=payload, headers=headers)
    data = response.json()
    return {
        "carbon_kg": data["data"]["attributes"]["carbon_kg"],
        "carbon_mt": data["data"]["attributes"]["carbon_mt"]
    }

legs = [
    {"departure_airport": "SFO", "destination_airport": "JFK"},
    {"departure_airport": "JFK", "destination_airport": "SFO"}
]
emissions = calculate_flight_emissions(1, legs)
print(f"Round trip emissions: {emissions['carbon_kg']} kg CO2")

Vehicle Emissions

def calculate_vehicle_emissions(distance_value, distance_unit, vehicle_model_id):
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    payload = {
        "type": "vehicle",
        "distance_unit": distance_unit,
        "distance_value": distance_value,
        "vehicle_model_id": vehicle_model_id
    }
    response = requests.post(f"{BASE_URL}/estimates", json=payload, headers=headers)
    return response.json()["data"]["attributes"]["carbon_kg"]

Electricity Emissions

def calculate_electricity_emissions(kwh, country="us", state="ca"):
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    payload = {
        "type": "electricity",
        "electricity_unit": "kwh",
        "electricity_value": kwh,
        "country": country,
        "state": state
    }
    response = requests.post(f"{BASE_URL}/estimates", json=payload, headers=headers)
    return response.json()["data"]["attributes"]["carbon_kg"]

co2 = calculate_electricity_emissions(500, "us", "ca")
print(f"500 kWh in California: {co2} kg CO2")

Personal Tracker Database

import sqlite3
from datetime import datetime
import pandas as pd

def init_tracker():
    conn = sqlite3.connect("carbon_tracker.db")
    cursor = conn.cursor()
    cursor.execute("""
        CREATE TABLE IF NOT EXISTS emissions (
            id INTEGER PRIMARY KEY AUTOINCREMENT,
            category TEXT, description TEXT,
            carbon_kg REAL, date TEXT
        )
    """)
    conn.commit()
    return conn

def log_emission(conn, category, description, carbon_kg):
    cursor = conn.cursor()
    cursor.execute(
        "INSERT INTO emissions (category, description, carbon_kg, date) VALUES (?, ?, ?, ?)",
        (category, description, carbon_kg, datetime.now().strftime("%Y-%m-%d"))
    )
    conn.commit()

def monthly_report(conn, month):
    df = pd.read_sql(
        "SELECT category, SUM(carbon_kg) as total_kg FROM emissions WHERE date LIKE ? GROUP BY category",
        conn, params=[f"{month}%"]
    )
    return df

conn = init_tracker()
log_emission(conn, "transport", "Daily commute", 5.2)
log_emission(conn, "electricity", "Home usage", 12.3)
print(monthly_report(conn, "2026-03"))

Scraping Environmental Data

For additional data sources like air quality or weather monitoring sites, use ScraperAPI for rendering, ThorData for proxy rotation, or ScrapeOps for pipeline monitoring.

Visualizing Your Footprint

def print_emissions(conn):
    df = pd.read_sql(
        "SELECT date, SUM(carbon_kg) as daily_total FROM emissions GROUP BY date ORDER BY date",
        conn
    )
    print("Daily Carbon Emissions (kg CO2):")
    for _, row in df.iterrows():
        bar = "#" * int(row["daily_total"])
        print(f"{row['date']}: {bar} {row['daily_total']:.1f} kg")

Conclusion

A carbon footprint tracker turns environmental awareness into actionable data. Start tracking your emissions and identify the biggest areas for reduction.

Happy building! Follow for more sustainability tech tutorials.

DEV Community