API Response Data Insights
The API generates results based on the parameters provided in the request. Below is an example of how the response is structured:
- PLM
- LCA
- Eco-Score
- CEI
- AGEC_FR
- Others

How to Communicate the API Parameters Effectively
⚠️ Notice: To use all this data, it is mandatory to include the following key elements in your design:
- Units (ex: kg CO2 eq, g phosphates eq, etc…) following each number: 1,2 does not mean nothing if we don’t know if it is 1,2 gram or kilogram.
- Version version: the results of the API will change from one version to the other, add it to the design so that your end-user is not misled.
- Analysis based on functional_unit: your end-users need to know if your results are presented for 1 unit, for 1 pair or for 1 set.
- Powered by BCome: it is always better to communicate who is your data provider to enhance transparency. The proposed link redirects the user to our website to obtain information about the methodology.
PLM
Traceability insights | Product journey facts.
Indicator | Definition | Example |
---|---|---|
processes | Average number of processes the article has gone through. | 39 processes |
supplier_traceability_rate | Score based on known suppliers by raw material, material and article. | 81% supplier traceability |
suppliers | Suppliers declared by article. | 7 suppliers declared |
km_traveled | Average distance in kilometers traveled by the product from raw material to warehouse. | 21819.47 km from origin to warehouse |
material_processing_origin | Main material processing country. | Material processing: Spain |
article_finishing_origin | Main article finishing country. | Article finishing: Italy |
article_manufacturing_origin | Main article manufacturing country. | Article manufacturing: Tunisia |
LCA
Environmental assessment | Cradle-to-gate analysis.
Indicator | Definition | Example |
---|---|---|
water_scarcity | Water scarcity impact of the article. Deprivation of water to humans and ecosystems due to water consumption in the product value chain. | Water scarcity 1.53 m3 water eq consumed |
water_scarcity_savings | Average percentage of water scarcity savings in all production compared to the industry standard. | Water scarcity Contributes to 71% less m3 water eq consumed |
water_scarcity_savings_absolute | Unitary water scarcity savings in all production compared to the industry standard. | Water scarcity 2.45 m3 water eq saved |
water_scarcity_equivalence | m3 water equivalent to water bottles. | Water scarcity 23.82 bottles |
global_warming | Climate change caused by the greenhouse effect of heat-trapping pollutants released from the product value chain. | Global warming 4.22 kg CO2 eq emitted |
global_warming_savings | Average percentage of global warming savings in all production compared to the industry standard. | Global warming Contributes to 68% less kg CO2 eq |
global_warming_savings_absolute | Unitary global warming savings in all production compared to the industry standard. | Global warming 1.98 kg CO2 eq saved |
global_warming_equivalence | kg CO2 equivalent to days of use of a LED light bulb. | Global warming 211.15 days a bulb is on |
eutrophication | Proliferation of algae into an ecosystem due to the excess release of phosphates and nitrates in the product value chain. | Eutrophication 3.51 g phosphates eq emitted |
eutrophication_savings | Average percentage of eutrophication savings in all production compared to the industry standard. | Eutrophication Contributes to 68% less g phosphates eq |
eutrophication_savings_absolute | Unitary eutrophication savings in all production compared to the industry standard. | Eutrophication 9.55 g phosphates eq saved |
eutrophication_equivalence | g phosphates eq equivalent to complete washing cycles in a laundry. | Eutrophication 0.65 washing cycles |
abiotic_depletion | Use of fossil fuels such as oil, natural gas, and coal for the production of energy consumed in the value chain. | Abiotic depletion 61.64 MJ consumed |
abiotic_depletion_savings | Average percentage of abiotic depletion savings in all production compared to the industry standard. | Abiotic depletion Contributes to 70% less MJ |
abiotic_depletion_savings_absolute | Unitary abiotic depletion savings in all production compared to the industry standard. | Abiotic depletion 43.34 MJ saved |
abiotic_depletion_equivalence | MJ equivalent to km traveled in a regular car. | Abiotic depletion 13.93 km driven |
water_consumption | Water or “blue water” consumption refers to the amount of water directly consumed in the product value chain, including fresh surface and groundwater, such as water in freshwater lakes, rivers, and aquifers. | Water consumption 414.42 liters water consumed |
water_consumption_savings | Average percentage of water consumption savings in all production compared to the industry standard. | Water consumption Contributes to 13.8% less liters of water |
water_consumption_savings_absolute | Unitary water consumption savings in all production compared to the industry standard. | Water consumption 66.32 liters of water saved |
water_consumption_equivalence | liters of water equivalent to water bottles. | Water consumption 276.42 bottles |
Eco-Score
Eco-Score | Sustainability performance index.
Indicator | Definition | Example |
---|---|---|
planet_score | Score based on practices for environmental efficiency and responsible use of resources. | Planet B |
planet_qualification | Planet performance scored out of 10. | Planet 7.14 / 10 points |
people_score | Score based on practices created to ensure safe and ethical work, social and animal conditions. | People A |
people_qualification | People performance scored out of 10. | People 8.4 / 10 points |
transparency_score | Score based on the practices and the commitment to monitoring, defining, and ensuring transparency in the value chain. | Transparency C |
transparency_qualification | Transparency performance scored out of 10. | Transparency 6.95 / 10 points |
circularity_score | Score based on practices established to ensure resource loops are closed and valuable materials are recovered. | Circularity A |
circularity_qualification | Circularity performance scored out of 10. | Circularity 9.13 / 10 points |
CEI
Circularity insights | Circular economy analysis.
Indicator | Definition | Example |
---|---|---|
material_circularity_indicator | Score based on the circularity of material flow in the item’s lifecycle and its usage duration and intensity compared to industry standard. | 74% circular based on MCI score (Ellen MacArthur Foundation) |
recycled_content | Proportion of materials included in the product derived from recycled sources. | 100% of recycled content |
total_unrecoverable_waste | Waste generated throughout the lifecycle of the item, which will be disposed of in landfills or incinerated. | 0,58 kg of waste no longer recoverable |
utility_percentage | Derived from the duration and intensity of use of an item compared to an average product in the industry of the same type. | 75% usage potential improvement based on eco-design best practices |
AGEC
Article 13 I of the French law on the fight against waste and the circular economy of February 10th, 2020 (AGEC) harmonizes, frames, and specifies, in terms of both content and presentation, several environmental claims. Content available only in French.
Indicator | Definition | Example |
---|---|---|
title | The title of the website or the page or the section of the dedicated page should be “product sheet related to environmental qualities and characteristics”, with the name and reference of the model concerned. | Fiche produit relative aux qualités et caractéristiques environnementales |
article_group | The article group is given as an informative parameter. Not mandatory. | Footwear |
manufacturing_country | The geographical area indicated must correspond to the country where most of the steps are performed. | Confection: Espagne |
material_processing_country | The geographical area indicated must correspond to the country where most of the steps are performed. | Tissage/tricotage: Turquie |
finishing_country | The geographical area indicated must correspond to the country where most of the steps are performed. | Teinture et impression: Turquie |
microplastics | The presence of plastic microfiber in textile products for clothing, footwear, and household linen must be declared if they contain > 50% synthetic fibers. The statement is “Releases plastic microfibers into the environment during washing”. | Rejette des microfibres plastiques dans l’environnement lors du lavage |
recycled_content | The recycled content must be mentioned. In case the product is fully recycled, it must be stated “Fully recycled product”, whereas only a part of the product must be recycled, the statement should correspond to “Product containing at least [%] recycled content.” | Produit comportant au moins 30% de matières recyclées |
hazardous_substances | If the product contains a dangerous substance in a concentration greater than 0.1% by mass percentage, the statement “contains a dangerous substance” or “contains a substance of very high concern” must be displayed. | Contient une substance dangereuse: DEHP |
Others indicators
Indicator | Definition | Example |
---|---|---|
version | The impacts displayed depend on the version of the analysis. Impacts from different versions are not comparable. | Version 1.6 |
project_name | – | AW24 |
functional_unit | The functional unit allows the end-user to understand the scope of the analysis. Impact calculated for 1 unit, 1 pair, 1 set, etc… | Analysis based on 1 unit |
name | – | Top Nathan |
reference | – | GA1644103 |
Frequent Communication Mistakes
Follow these tips to avoid common communication errors and ensure your message is clear, concise, and effective in any context:
1. Always keep the unit of measurement and “eq”.
- For example: “This t-shirt has consumed 29,03 m3 water eq.“
2. Mention the indicator being referenced and don’t use alternative indicators. For example:
- For example: “This t-shirt has contributed to water scarcity through the consumption of 29,03 m3 water eq.“
For more information, we recommend reading our Do’s and don’ts in data communication guide.
Designing E-commerce with API Data
Learn how to leverage API data to create stunning website designs. Be inspired and maintain transparency by showcasing valuable insights.
Related articles
How to Integrate via API Platform