# Ducky Data V3 - climate data APIs API

> Ducky Data V3 - climate data APIs API on Apizie: 22 endpoints (Get kgCO2e per monetary transaction, Get kgCO2e, weight, waste, and money spent per food category., Calculate annual footprint by categories, Get tips for improving behaviour., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/open-data:ducky/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:ducky`
- Category: Open Data
- Status: byok
- Source: https://www.ducky.eco
- Page: https://apizie.tech/api/open-data/ducky
- OpenAPI: https://apizie.tech/api/open-data/ducky/openapi.json

Ducky Data's APIs provide footprint data for a wide variety of products and circular services, as well as individuals, and consumption-based emissions for municipalities and other administrative units. The endpoints…

## Endpoints

### Get kgCO2e per monetary transaction
`POST https://apizie.tech/v1/open-data:ducky/calculate-financial-footprint-for-transactions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataSource | string | no | Data Source to use for calculation |
| categoryMapping | string | no | Format output based on a custom mapping |
| dataFromDate | string | no | You can choose to use data from any date for which we have data in our database. If you do not submit a date, the current (and thereby the… |
| body | object | yes | JSON request body |

### Get kgCO2e, weight, waste, and money spent per food category.
`POST https://apizie.tech/v1/open-data:ducky/calculate-food-and-drink-metrics` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataSource | string | no | Data Source to use for calculation |
| dataFromDate | string | no | You can choose to use data from any date for which we have data in our database. If you do not submit a date, the current (and thereby the… |
| body | object | yes | JSON request body |

### Calculate annual footprint by categories
`POST https://apizie.tech/v1/open-data:ducky/calculate-annual-footprint-by-categories` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataSource | string | no | Data Source to use for calculation |
| categories | array | no | Categories to include in response |
| subCategories | boolean | no | Include subcategories |
| scope | string | no | Is the footprint for an individual or a household |
| precision | boolean | no | Prevent rounding of percentages |
| dataFromDate | string | no | You can choose to use data from any date for which we have data in our database. If you do not submit a date, the current (and thereby the… |
| body | object | yes | JSON request body |

### Get tips for improving behaviour.
`POST https://apizie.tech/v1/open-data:ducky/change-improve-behaviour-tips` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataSource | string | no | Region of the requested data set |
| dataFromDate | string | no | You can choose to use data from any date for which we have data in our database. If you do not submit a date, the current (and thereby the… |
| language | string | no | Language of the text returned |
| orderBy | string | no | Order the results using the specified attribute. The attributes of type "indicator" (co2, points, moneySaved) are sorted by descending… |
| returnLegacyTipId | boolean | no | Choose whether the legacy tipID should be outputted. |
| ignoreZeroOrNegativeTips | boolean | no | Choose whether to ignore tips that would produce a zero or negative impact in terms of CO2 footprint. Such cases will happen if a user… |
| body | object | no | JSON request body |

### Fetch an average food-and-drink footprint based on filtering criteria.
`POST https://apizie.tech/v1/open-data:ducky/compare-average-footprint-by-filtering-criteria` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Fetch an average category-based footprint based on filtering criteria.
`POST https://apizie.tech/v1/open-data:ducky/compare-average-category-footprint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Fetch transport footprint for a given area.
`POST https://apizie.tech/v1/open-data:ducky/compare-transport-footprint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataFromDate | string | no | You can choose to use data from any date for which we have data in our database. If you do not submit a date, the current (and thereby the… |
| areaId | string | yes | Area code of the area for which transport footprint is requested. [See detailed area ID… |
| timeRange | string | no | Choose which time range you wish to receive data for. Currently the most granular data available is per month, which means that if a… |

### Get kgCO2e per kWh used.
`POST https://apizie.tech/v1/open-data:ducky/convert-kg-co2e-per-kwh-used` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataSource | string | no | Data Source to use for calculation |
| dataFromDate | string | no | You can choose to use data from any date for which we have data in our database. If you do not submit a date, the current (and thereby the… |
| body | object | yes | JSON request body |

### Get footprint in kilograms of CO2-equivalents for financial transactions by category.
`POST https://apizie.tech/v1/open-data:ducky/convert-financial-footprint-by-category` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataSource | string | no | Data Source to use for calculation |
| dataFromDate | string | no | You can choose to use data from any date for which we have data in our database. If you do not submit a date, the current (and thereby the… |
| body | object | yes | JSON request body |

### Get kgCO2e per calory or weight of Food and Drink.
`POST https://apizie.tech/v1/open-data:ducky/convert-food-and-drink-footprint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataSource | string | no | Data Source to use for calculation |
| dataFromDate | string | no | You can choose to use data from any date for which we have data in our database. If you do not submit a date, the current (and thereby the… |
| body | object | yes | JSON request body |

### Get footprint of an item and optionally the avoided emissions obtained by choosing to rent, repair or buy an…
`POST https://apizie.tech/v1/open-data:ducky/convert-item-footprint-and-savings` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataSource | string | no | Data Source to use for calculation |
| dataFromDate | string | no | You can choose to use data from any date for which we have data in our database. If you do not submit a date, the current (and thereby the… |
| body | object | yes | JSON request body |

### Get a list of all valid items for the convert/goods-and-services endpoint.
`GET https://apizie.tech/v1/open-data:ducky/convert-goods-and-services-list-items` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataSource | string | no | Data Source to use for calculation |
| dataFromDate | string | no | You can choose to use data from any date for which we have data in our database. If you do not submit a date, the current (and thereby the… |

### Get kgCO2e per distance travelled.
`POST https://apizie.tech/v1/open-data:ducky/convert-transport-emissions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataSource | string | no | Data Source to use for calculation |
| dataFromDate | string | no | You can choose to use data from any date for which we have data in our database. If you do not submit a date, the current (and thereby the… |
| body | object | yes | JSON request body |

### Check if the API is running
`GET https://apizie.tech/v1/open-data:ducky/ping-status-check` (byok)

### Check if the API is running and if your authentication token is valid
`GET https://apizie.tech/v1/open-data:ducky/ping-check-token-validity` (byok)

### Compute Scope 1 GHG emissions.
`POST https://apizie.tech/v1/open-data:ducky/reporting-compute-scope1-emissions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataSource | string | no | Data Source to use for calculation |
| dataFromDate | string | no | You can choose to use data from any date for which we have data in our database. If you do not submit a date, the current (and thereby the… |
| body | object | yes | JSON request body |

### Compute Scope 2 GHG emissions.
`POST https://apizie.tech/v1/open-data:ducky/reporting-compute-scope2-emissions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataSource | string | no | Data Source to use for calculation |
| dataFromDate | string | no | You can choose to use data from any date for which we have data in our database. If you do not submit a date, the current (and thereby the… |
| body | object | yes | JSON request body |

### Get indicators for a certain administrative area.
`POST https://apizie.tech/v1/open-data:ducky/track-transport-indicators` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataFromDate | string | no | You can choose to use data from any date for which we have data in our database. If you do not submit a date, the current (and thereby the… |
| timeRange | string | no | Choose which time range you wish to receive data for. Currently the most granular data available is per month, which means that if a… |
| body | object | yes | JSON request body |

### Translate kilograms CO2 equivalent to distance travelled by car
`POST https://apizie.tech/v1/open-data:ducky/translate-co2e-to-car-distance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataSource | string | no | Region of the requested data set |
| dataFromDate | string | no | You can choose to use data from any date for which we have data in our database. If you do not submit a date, the current (and thereby the… |
| body | object | no | JSON request body |

### Translate kilograms CO2 equivalent to the usage of an electrical appliance.
`POST https://apizie.tech/v1/open-data:ducky/translate-co2e-to-energy-usage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataSource | string | no | Region of the requested data set |
| dataFromDate | string | no | You can choose to use data from any date for which we have data in our database. If you do not submit a date, the current (and thereby the… |
| body | object | no | JSON request body |

### Translate kilograms CO2 equivalent to distance flown by an airplane.
`POST https://apizie.tech/v1/open-data:ducky/translate-co2e-to-plane-distance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataSource | string | no | Region of the requested data set |
| dataFromDate | string | no | You can choose to use data from any date for which we have data in our database. If you do not submit a date, the current (and thereby the… |
| body | object | no | JSON request body |

### Translate kilograms CO2 equivalent to how quickly it can be absorbed by a number of trees.
`POST https://apizie.tech/v1/open-data:ducky/translate-co2e-to-tree-area` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dataSource | string | no | Region of the requested data set |
| body | object | no | JSON request body |

## Example
```
curl "https://apizie.tech/v1/open-data:ducky/calculate-financial-footprint-for-transactions" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Ducky Data V3 - climate data APIs API?
Create a free Apizie key, then send POST https://apizie.tech/v1/open-data:ducky/calculate-financial-footprint-for-transactions with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Ducky Data V3 - climate data APIs API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Ducky Data V3 - climate data APIs itself also needs your own key from api.ducky.eco.

### Can AI agents use the Ducky Data V3 - climate data APIs API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key open-data:ducky.

### What is the status of the Ducky Data V3 - climate data APIs API?
Needs your own provider key (bring your own key)