Ducky Data V3 - climate data APIs

Name: Ducky Data V3 - climate data APIs API
Brand: Ducky Data V3 - climate data APIs
Availability: InStock

★ Only Publicly Available OpenAPI DocumentData EnrichmentData TransformationapiKey22 EndpointsREST

For Agents

Convert energy use, transactions, food, and transport into CO2-equivalents and translate emissions into relatable units like trees or flight distance through Ducky Data.

Connect the Ducky Data V3 - climate data APIs to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Ducky Data V3 - climate data APIs, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Install Jentic One Beta (Self-Hosted)

Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Ducky Data V3 - climate data APIs API.

Convert financial transactions, energy, food, and transport to kgCO2e via the /convert endpoints

Calculate an individual's annual footprint by category via POST /calculator

Generate behavioural sustainability tips via POST /change

Compare a footprint against area averages via the /compare endpoints

GET STARTED

Start building with Ducky Data V3 - climate data APIs API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for Ducky Data V3 - climate data APIs, keeping it validated and agent-ready.

Ducky Data is a climate footprint API that calculates, compares, converts, and translates CO2-equivalent emissions for individuals, products, and administrative areas. The API exposes 22 endpoints grouped by function: Calculate (annual or category footprint), Change (sustainability tips), Compare (area averages), Convert (energy, finance, food, goods, transport to kgCO2e), Reporting (GHG Scope 1 and 2), Track (area indicators), and Translate (kgCO2e to relatable units like flights or trees). Authentication uses an Auth0-issued access_token sent as an Authorization header.

Use Cases

Patterns agents use Ducky Data V3 - climate data APIs API for, with concrete tasks.

★ Carbon Footprint Calculator in a Banking App

Estimate the climate impact of customer transactions inside a banking or expense app. POST /convert/finance accepts a monetary amount and category and returns kgCO2e, which the agent surfaces beside each transaction. Pair with /translate/tree or /translate/plane to render the impact in tangible units the customer understands.

POST /convert/finance with amount=120 and category='groceries', then POST /translate/tree with the returned kgCO2e to render 'equivalent to X trees per year'

Annual Personal Footprint Calculator

Compute a complete annual footprint for an individual based on home energy, transport, food, and consumption habits. POST /calculator returns the breakdown by category, which an agent can present back as a sustainability dashboard. POST /change then suggests tailored actions, and POST /compare/general puts the result in context against an area average.

POST /calculator with the user's habits, then POST /compare/general for the area average, then POST /change to fetch personalised tips

Corporate GHG Reporting (Scope 1 and 2)

Compute the Scope 1 and Scope 2 emissions a company must report under the GHG Protocol. POST /report/scope-1 takes direct emissions inputs such as fuel use, and POST /report/scope-2 takes purchased electricity and heat. Agents can wire these into accounting or ESG tooling so the calculation runs from the same data feeds that drive financial reporting.

POST /report/scope-2 with annual purchased electricity in kWh and the country code, then write the kgCO2e output into the ESG dashboard

Agent-Driven Sustainability Insights via Jentic

Wire Ducky Data into agent workflows that score, compare, and translate emissions. Through Jentic the agent searches by intent, loads the schema for the right /convert or /translate endpoint, and executes — the access_token stays in the Jentic vault, not the agent's prompt context.

Search Jentic for 'convert energy use to kgCO2e', load the schema for POST /convert/energy, and execute with the kWh value supplied by the parent workflow

Key Endpoints

22 endpoints — ducky data is a climate footprint api that calculates, compares, converts, and translates co2-equivalent emissions for individuals, products, and administrative areas.

METHOD

PATH

DESCRIPTION

POST

/convert/energy

Convert kWh of energy use to kgCO2e

POST

/convert/finance

Convert a monetary transaction to kgCO2e

POST

/calculator

Calculate an annual footprint by category

POST

/report/scope-1

Compute Scope 1 GHG emissions

POST

/report/scope-2

Compute Scope 2 GHG emissions

POST

/translate/tree

Translate kgCO2e into tree-absorption equivalence

POST

/change

Get behavioural sustainability tips

POST

/convert/energy

Convert kWh of energy use to kgCO2e

POST

/convert/finance

Convert a monetary transaction to kgCO2e

POST

/calculator

Calculate an annual footprint by category

POST

/report/scope-1

Compute Scope 1 GHG emissions

POST

/report/scope-2

Compute Scope 2 GHG emissions

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Ducky CLIENT_ID, CLIENT_SECRET, and Auth0 access_tokens are stored encrypted in the Jentic vault. Agents receive scoped access at execution, so neither the secret nor the bearer token enters the agent's prompt context.

Intent-based discovery

Agents search Jentic by intent (for example 'convert energy use to kgCO2e' or 'compute Scope 2 emissions') and Jentic returns the matching Ducky operation with its input schema.

Time to first call

Direct Ducky integration: 1-2 days for the Auth0 token negotiation flow and request shaping. Through Jentic: under 1 hour — search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Climatiq API

Emission factor API with broader activity coverage than Ducky's category-based shape

Choose Climatiq when the workflow needs raw emission factors and granular activity selection; choose Ducky for ready-to-render footprints and behavioural tips

Complementary

Cloverly API

Carbon offset purchase API that pairs with footprint calculation

Pair with Ducky when the agent first calculates a footprint with /convert and then offsets the result through Cloverly

Complementary

Auth0 Management API

The auth provider Ducky uses for token issuance

Pair with Ducky when the agent manages Auth0 clients used to negotiate Ducky access tokens

FAQs

Specific to using Ducky Data V3 - climate data APIs API through Jentic.

What authentication does the Ducky Data API use?

Ducky Data uses an Auth0-issued access_token sent as an Authorization header. Customers email Ducky for a CLIENT_ID and CLIENT_SECRET, then negotiate the token with Auth0. Through Jentic the credentials are stored in the encrypted vault and the token is injected at execution, so secrets never enter the agent's prompt.

Can I calculate Scope 2 emissions with the Ducky Data API?

Yes. POST /report/scope-2 accepts purchased electricity and heat inputs and returns kgCO2e under the GHG Protocol. POST /report/scope-1 covers direct emissions like fuel combustion.

How do I convert a transaction amount to CO2-equivalent through Jentic?

Search Jentic for 'convert finance transaction to CO2', load the schema for POST /convert/finance, and execute with the amount and category. Install with pip install jentic.

What are the rate limits for the Ducky Data API?

The OpenAPI spec does not declare rate limits. Ducky sets quotas per contract; have your agent handle 429 responses with exponential backoff and confirm the active limits with Ducky support.

Can I show users their footprint in relatable units?

Yes. The /translate endpoints convert kgCO2e into car distance (/translate/car), plane distance (/translate/plane), energy use (/translate/energy), or trees needed to absorb it (/translate/tree).

Does Ducky Data return tips to reduce a footprint?

Yes. POST /change accepts the user's habits and returns climate-friendly tips, which agents can use to nudge users toward lower-impact behaviour.