Breadcrumbs

Promote an ethical way of Shopping

https://developers.kelkoogroup.com/api/assets?path=pub020Guides%3Emaster%3E/./assets/images/ethicalpublishers.png

At Kelkoo Group, we have consistently placed importance on highlighting green and ethical shopping options to our users. Part of that initiative is to provide our publishers with the tools needed to identify and expose both offers and merchants that espouse a similar philosophy.

You can find out more about Kelkoo's company ethos on our website: https://www.kelkoogroup.com/green-awareness/

As Kelkoo Group publisher, you now have the ability to leverage the same tools developed for the Kelkoo website to identify and highlight green and ethical offers.

Ethical fields

The offer has been enriched with specific ethical fields which you can find in the table below.

The offer model is the same for:

  • Offer feeds

  • Offer search

So you can use these fields across all our services.

Check the offer fields reference for more details on other fields.

field

type

description

examples

ethicalType

string

Group greenLabel in a reduced list of types to make it easier to manage.

Environmental Friendly, Recycled material, Refilable Product, Handmade, Organic, Vegan & Cruelty-Free, Fair Trade, Second-hand & Refurbished, Eco packaging, Locally produced...

greenLabel

string

The eco-label(s) the product is certified with.

EU-Eco-regulation, NF Environment, FSC, Fair Trade...

flagGreenProduct

boolean

Set to true when greenLabel field is filled or when title or description matches a list of defined keywords.

This list is made up of ethical keywords, ethical brand names and ecolabels.

Ecolabels are mainly sourced from:


Ethical brand names are coming from those indexes:


madeIn

string

Country where the product was manufactured.

Australia, France, Italy...

efficiencyClass

string

Energy efficiency class of the product.

A++, A+, A, B, C, D, E, F, G

Retrieve ethical offers only

  • Facet on ethicalType field to get the distribution and be able to filter on a specific ethicalType: for instance, ethicalType:"Environmental Friendly". Check facet details.

  • Filter the flagGreenProduct field.

Check the offer search feature for more details on the general usage.

On Offer feed

Filter the feed after or during the download stream based on the flagGreenProduct field.

For instance:

Bash
#!/usr/bin/env bash

# Variables to update
COUNTRY=fr
CATID=138001
TOKEN="your token generated from the Publisher Center"
SHOPPING_API_URL="https://api.kelkoogroup.net/publisher/shopping/v2"

# Download a feed as JSON on a specific category, filter on flag.greenProduct == true
FORMAT=json
FILENAMEUNZIPPED="offersFeed_${COUNTRY}.cat-${CATID}.${FORMAT}"
FILENAME="${FILENAMEUNZIPPED}.gz"
curl -sS -o ${FILENAME} -H "Accept-Encoding: gzip" -H "Authorization: Bearer ${TOKEN}"  -s "${SAPIURL}/feeds/offers?country=${COUNTRY}&categoryId=${CATID}&format=${FORMAT}&fieldsAlias=minimal&additionalFields=greenLabel,flagGreenProduct"
gunzip $FILENAME
cat $FILENAMEUNZIPPED |  jq '.[] | select( .flag.greenProduct == true) '

Check the offer feed feature and guides for more details on the general usage.