GreenCode AI

API Overview

The GreenCodeAI Public API provides programmatic access to our environmental impact database. Integrate real-time rankings, company metrics, and historical data into your applications, research, or monitoring dashboards.

100% Free

No charges for public access. Rate limits apply for fair usage.

Open Source

API documentation and examples available on GitHub.

Real-Time Data

Rankings updated monthly, carbon intensity updated daily.

Potential Use Cases

Research & Analysis

Access environmental data for academic research on AI sustainability trends.

Developer Tools

Integrate rankings data into your applications or monitoring dashboards.

ESG Reporting

Reference environmental metrics for compliance documentation.

Available Endpoints

RESTful API with JSON responses. All endpoints support HTTPS only.

Authentication & Rate Limits

Currently, the API is open and does not require authentication for public endpoints. Rate limits are enforced to ensure fair usage.

Public Access (No API Key)

100 requests per hour
1,000 requests per day
IP-based throttling

Premium Access (With API Key) - Coming Soon

10,000 requests per hour
Unlimited daily requests
Priority support
Webhook notifications

Premium API keys will be available for organizations requiring higher limits or guaranteed uptime.

Required Headers

Content-Type→application/json

All requests must specify JSON format

User-Agent→YourApp/1.0

Identify your application for monitoring

Code Examples

Quick start examples in popular programming languages.

cURL

curl -X GET "https://greencodeai.eu/api/rankings?limit=10" \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyApp/1.0"

JavaScript (Fetch)

fetch('https://greencodeai.eu/api/rankings?limit=10', {
  headers: {
    'Content-Type': 'application/json',
    'User-Agent': 'MyApp/1.0'
  }
})
  .then(response => response.json())
  .then(data => console.log(data.rankings))
  .catch(error => console.error('Error:', error));

Python (Requests)

import requests

url = "https://greencodeai.eu/api/rankings"
params = {"limit": 10}
headers = {
    "Content-Type": "application/json",
    "User-Agent": "MyApp/1.0"
}

response = requests.get(url, params=params, headers=headers)
rankings = response.json()["rankings"]
print(rankings)

Planned Roadmap

1

Phase 1: Backend Infrastructure

In ProgressQ1-Q2 2026

Database setup and data pipeline
API routes implementation
Initial data collection

2

Phase 2: Public API Beta

PlannedQ3 2026

Basic endpoints (/rankings, /companies/:id)
Rate limiting
Documentation

Under Development

The Public API is currently under development. This page will be updated as implementation progresses.

Back to Home

Timeline and features subject to change.

Public API