Offers feeds - Response | Kelkoo Group Help Center

The response will be a stream of offers in the format defined in the request. You can choose among 3 response formats: JSON, XML or CSV.

To handle properly this stream, please follow the streaming guide. This is the same format as Offer search.

Only a few fields are presented in the following examples.

Quota

In case you have exceeded your allowed number of downloaded offers (per day and country), you will receive a response with HTTP code 429 Too Many Requests. See details.

Json format

Add specific fields in addition to the most useful ones

When I call KelkooGroup API with a valid JWT on https://api.kelkoogroup.net/publisher/shopping/v2/feeds/offers?country=fr&format=json&fieldsAlias=minimal&additionalFields=ecotax&categoryId=100565013
Then I get a response containing the following json content

JSON

[
  {
    "offerId": "7701b65469b409bcba9272e6be514c6d",
    "ecotax": 0.3,
    "title": "PUMA Chaussure de course Flyer Runner, Noir, Taille 48.5, Chaussures",
    "price": 30.36,
    "priceWithoutRebate": 37.95,
    "rebatePercentage": 25,
    "deliveryCost": 5.95,
    "currency": "EUR",
    "availabilityStatus": "in_stock",
    "timeToDeliver": "2-3 jours",
    "images": [
      {
        "url": "http://r.kelkoo.com/resize.php?country=fr&merchantId=100503542&categoryId=100565013&trackingId=96948759&width=90&height=90&image=http%3A%2F%2Fimagecache.com%2Fmain.jpg&sign=G7DCNtnY8vRZg0bwX1iaNzwhADFV1xKXSKnPS7sJRMo-",
        "zoomUrl": "http://r.kelkoo.com/resize.php?country=fr&merchantId=100503542&categoryId=100565013&trackingId=96948759&width=auto&height=auto&image=http%3A%2F%2Fimagecache.com%2Fmain.jpg&sign=G7DCNtnY8vRZg0bwX1iaNzwhADFV1xKXSKnPS7sJRMo-"
      }
    ],
    "goUrl": "https://fr-go.kelkoogroup.net/offersearchGo?.ts=1516377600000&.sig=fc51_gBNu48V4W4RaYjxZFv1zTo-&affiliationId=96948759&comId=100503542&country=fr&offerId=7701b65469b409bcba9272e6be514c6d&service=37&tokenId=tokenId1234&wait=true",
    "estimatedCpc": 0.2,
    "estimatedMobileCpc": 0.19,
    "brand": {
      "name": "Puma"
    },
    "merchant": {
      "id": 100503542
    },
    "category": {
      "id": 100565013
    }
  }
]

Select only the fields needed without using the minimal ones with json format

When I call KelkooGroup API with a valid JWT on https://api.kelkoogroup.net/publisher/shopping/v2/feeds/offers?country=fr&format=json&fieldsAlias=none&additionalFields=offerId,title,lastUpdateDate,price,currency,flagOffensiveContent,codeEan,imageUrl,image2Url,offerUrlLandingUrl,goUrl,estimatedCpc,merchantId&categoryId=100565013
Then I get a response containing the following json content

JSON

[
  {
    "offerId": "7701b65469b409bcba9272e6be514c6d",
    "title": "PUMA Chaussure de course Flyer Runner, Noir, Taille 48.5, Chaussures",
    "lastUpdateDate": "2020-09-07T10:20:30Z",
    "price": 30.36,
    "currency": "EUR",
    "flag": {
      "offensiveContent": false
    },
    "code": {
      "ean": "4044641108264"
    },
    "images": [
      {
        "url": "http://r.kelkoo.com/resize.php?country=fr&merchantId=100503542&categoryId=100565013&trackingId=96948759&width=90&height=90&image=http%3A%2F%2Fimagecache.com%2Fmain.jpg&sign=G7DCNtnY8vRZg0bwX1iaNzwhADFV1xKXSKnPS7sJRMo-"
      },
      {
        "url": "http://r.kelkoo.com/resize.php?country=fr&merchantId=100503542&categoryId=100565013&trackingId=96948759&width=90&height=90&image=http%3A%2F%2Fimagecache.com%2F1.jpg&sign=mu._Vie8CenJqC3O_lH.Sq4TYaWn0JsEHgEd0sxiej8-"
      }
    ],
    "offerUrl": {
      "landingUrl": "https://eu.puma.com/fr/fr/pd/basket-cali-0/369337.html?dwvar_369337_size=0240&dwvar_369337_color=04&mktID=AFF:KelKoo:%5Bcampaign%5D:FR&utm_medium=AFF&utm_source=KelKoo&utm_campaign=%5Bcampaign%5D"
    },
    "goUrl": "https://fr-go.kelkoogroup.net/offersearchGo?.ts=1516377600000&.sig=fc51_gBNu48V4W4RaYjxZFv1zTo-&affiliationId=96948759&comId=100503542&country=fr&offerId=7701b65469b409bcba9272e6be514c6d&service=37&tokenId=tokenId1234&wait=true",
    "estimatedCpc": 0.2,
    "merchant": {
      "id": 100503542
    }
  }
]

Xml format

Select only the fields needed without using the minimal ones with xml format

When I call KelkooGroup API with a valid JWT on https://api.kelkoogroup.net/publisher/shopping/v2/feeds/offers?country=fr&format=xml&fieldsAlias=none&additionalFields=offerId,title,lastUpdateDate,price,currency,flagOffensiveContent,codeEan,imageUrl,image2Url,offerUrlLandingUrl,goUrl,estimatedCpc,merchantId&categoryId=100565013
Then the response has following content

XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ShoppingOffers>
    <ShoppingOffer>
        <OfferId>7701b65469b409bcba9272e6be514c6d</OfferId>
        <Title>PUMA Chaussure de course Flyer Runner, Noir, Taille 48.5, Chaussures</Title>
        <LastUpdateDate>2020-09-07T10:20:30Z</LastUpdateDate>
        <Price>30.36</Price>
        <Currency>EUR</Currency>
        <Flag>
            <OffensiveContent>false</OffensiveContent>
        </Flag>
        <Code>
            <Ean>4044641108264</Ean>
        </Code>
        <Images>
          <Url>http://r.kelkoo.com/resize.php?country=fr&amp;merchantId=100503542&amp;categoryId=100565013&amp;trackingId=96948759&amp;width=90&amp;height=90&amp;image=http%3A%2F%2Fimagecache.com%2Fmain.jpg&amp;sign=G7DCNtnY8vRZg0bwX1iaNzwhADFV1xKXSKnPS7sJRMo-</Url>
          <ZoomUrl/>
        </Images>
        <Images>
          <Url>http://r.kelkoo.com/resize.php?country=fr&amp;merchantId=100503542&amp;categoryId=100565013&amp;trackingId=96948759&amp;width=90&amp;height=90&amp;image=http%3A%2F%2Fimagecache.com%2F1.jpg&amp;sign=mu._Vie8CenJqC3O_lH.Sq4TYaWn0JsEHgEd0sxiej8-</Url>
          <ZoomUrl/>
        </Images>
        <OfferUrl>
            <LandingUrl>https://eu.puma.com/fr/fr/pd/basket-cali-0/369337.html?dwvar_369337_size=0240&amp;dwvar_369337_color=04&amp;mktID=AFF:KelKoo:%5Bcampaign%5D:FR&amp;utm_medium=AFF&amp;utm_source=KelKoo&amp;utm_campaign=%5Bcampaign%5D</LandingUrl>
        </OfferUrl>
        <GoUrl>https://fr-go.kelkoogroup.net/offersearchGo?.ts=1516377600000&amp;.sig=fc51_gBNu48V4W4RaYjxZFv1zTo-&amp;affiliationId=96948759&amp;comId=100503542&amp;country=fr&amp;offerId=7701b65469b409bcba9272e6be514c6d&amp;service=37&amp;tokenId=tokenId1234&amp;wait=true</GoUrl>
        <EstimatedCpc>0.20</EstimatedCpc>
        <Merchant>
            <Id>100503542</Id>
        </Merchant>
    </ShoppingOffer>
</ShoppingOffers>

Csv format

Select only the fields needed without using the minimal ones with csv format

When I call KelkooGroup API with a valid JWT on https://api.kelkoogroup.net/publisher/shopping/v2/feeds/offers?country=fr&format=csv&fieldsAlias=none&additionalFields=offerId,title,lastUpdateDate,price,currency,flagOffensiveContent,codeEan,imageUrl,image2Url,offerUrlLandingUrl,flagGreenProduct,goUrl,estimatedCpc,merchantId&categoryId=100565013
Then the response has following content

"offer_id","title","last_update_date","price","currency","flag_offensive_content","flag_green_product","code_ean","image_url","image_2_url","offer_url_landing_url","go_url","estimated_cpc","merchant_id"
"7701b65469b409bcba9272e6be514c6d","PUMA Chaussure de course Flyer Runner, Noir, Taille 48.5, Chaussures","2020-09-07T10:20:30Z","30.36","EUR","false","true","4044641108264","http://r.kelkoo.com/resize.php?country=fr&merchantId=100503542&categoryId=100565013&trackingId=96948759&width=90&height=90&image=http%3A%2F%2Fimagecache.com%2Fmain.jpg&sign=G7DCNtnY8vRZg0bwX1iaNzwhADFV1xKXSKnPS7sJRMo-","http://r.kelkoo.com/resize.php?country=fr&merchantId=100503542&categoryId=100565013&trackingId=96948759&width=90&height=90&image=http%3A%2F%2Fimagecache.com%2F1.jpg&sign=mu._Vie8CenJqC3O_lH.Sq4TYaWn0JsEHgEd0sxiej8-","https://eu.puma.com/fr/fr/pd/basket-cali-0/369337.html?dwvar_369337_size=0240&dwvar_369337_color=04&mktID=AFF:KelKoo:%5Bcampaign%5D:FR&utm_medium=AFF&utm_source=KelKoo&utm_campaign=%5Bcampaign%5D","https://fr-go.kelkoogroup.net/offersearchGo?.ts=1516377600000&.sig=fc51_gBNu48V4W4RaYjxZFv1zTo-&affiliationId=96948759&comId=100503542&country=fr&offerId=7701b65469b409bcba9272e6be514c6d&service=37&tokenId=tokenId1234&wait=true","0.20","100503542"