Roadmap
Changelog

February 19th, 2026

Koi Data API: Programmatic Access to Climate Technology Data

What's new

  • REST API — Search for climate technologies, GHG emission intensities, and addressable markets using natural language queries powered by vector search

  • Secure API key authentication — Organization-scoped API keys with role-based permissions that inherit from your license tier and integrate seamlessly with Koi's existing access controls

  • Auto-generated OpenAPI documentation — Explore and interact with the available endpoints in the Koi Docs

Why is it important?

Climate impact analysis shouldn't be locked inside a single application. The Koi Data API unlocks programmatic access to our climate technology database, enabling you to integrate impact data directly into your workflows, tools, and applications. Whether you're building internal dashboards, automating portfolio analysis, or enriching your own datasets, the API gives you the flexibility to use Koi's data where and how you need it—without manual exports or copy-paste workflows.

This opens new possibilities: automated screening processes, real-time impact monitoring, custom reporting systems, and seamless integration with your existing data infrastructure. Your API keys inherit your organization's permissions, so you maintain the same access controls and data quality standards you rely on in the Koi web application.

How Do I Use It?

1. Request an API Key

Contact us to request an API key for your organization.

2. Make Your First Request

Use your API key to search for climate technologies:

curl https://api.koi.eco/v0/query/technologies \ --request POST \ --header 'Content-Type: application/json' \ --header 'koi-api-key: YOUR_SECRET_TOKEN' \ --data '{ "query": "", "topK": 1000, "limit": 5, "dataScope": "public", "includeAnalysis": false, "includeIndustries": false, "qaStatusFilter": [ "FULLVAL" ], "analysisPeriod": { "startYear": 2025, "endYear": 2040 } }'

The API returns structured data including technology descriptions, GHG impact calculations, addressable market sizes, industry classifications, and quality assurance indicators.

3. Explore the Full API

Refer to our documentation at https://docs.koi.eco/docs/api/reference to explore all available endpoints, request parameters, and response schemas.

Who is this for?

  • Data Engineers — Integrate Koi's climate data into internal data warehouses, ETL pipelines, or analytics platforms

  • Impact Analysts — Build custom screening tools, automated reports, or portfolio-wide impact dashboards

  • Product Teams — Embed climate impact data into your own applications and user experiences

FAQ

  • How does API key authentication work? API keys are SHA-256 hashed and stored securely in the database. They inherit permissions from your organization's active license tier and the role assigned to the key.

  • What happens if I exceed my organization's usage limits? API keys follow the same credit and permission model as the web application. If your organization runs out of credits or your license tier changes, API access will be adjusted accordingly. Contact your account manager if you need to increase capacity.