Kitefinder Shop API

Product feed - documentation

Introduction

KiteFinder is the one and only Search Engine for kitesurf hardware information. The information is formed by Brand info, online reviews and realtime product overview.

Our reviews aren’t only helpful for kitesurfers, it’s been proven in different industries that information platforms play an important part in the decision making process of buying equipment!

1. Getting Started

Thursday 21st of September 2017 03:13:05 AM

This guide will help you connect your product feed with Kitefinder Shop using the Kitefinder API. Before you can start coding, there are a few things you need to do.

Register your shop

Please send a mail to info@kitefinder.com with the following information:

  • Shop name
  • Contact person
  • Telephone number
  • Shop description
  • Shop URL
  • Shop country of Residence

2. Fields

Property name Value Description Required
id integer The REST id of the product. Yes
title string Title of the product. Yes
brand string Brand of the product. Yes
description string Description of the product. Yes
link string URL directly linking to the page of the product on your website. Yes
imageLink string URL of an image of the product. Yes
contentLanguage string The two-letter ISO 639-1 language code for the item. Yes
availability string Availability status of the product.

Acceptable values are:
  • "in stock"
  • "out of stock"
  • "preorder"
 Yes
productCategory string Kitefinder's category of the product (see Kitefinder shop categories). Yes
condition string Condition or state of the product.

Acceptable values are:
  • "new"
  • "refurbished"
  • "used"
 Yes
color string Color of the product. No
price double Price of the product. Yes
shippingCosts double Shipping costs of the product. Yes
currency string The currency of the price. Yes
ean string EAN-13 barcode of the product. No

3. JSON Example

This is an example of an product feed output

{
   "products":[
     {
	  "id":"2345",
	  "title":"Naish Trip 2015",
	  "brand":"Naish",
	  "description":"The Trip is a cutting-edge, strutless kite that is ideal for...",
	  "link":"http:\/\/www.example.com\/product\/2345",
	  "imageLink":"http:\/\/www.example.com\/img\/2345.jpg",
	  "contentLanguage":"en",
	  "availability":"in stock",
	  "productCategory":"kites",
	  "productSubCategory":"race",
	  "condition":"new",
	  "color":"red",
	  "price":"1199.99",
	  "shippingCosts":"3.15",
	  "currency":"EUR",
	  "ean":"75678164125"
      }, {
	  "id":"2423",
	  "title":"Ozone Trip 2015",
	  "brand":"Ozone",
	  "description":"The Trip is a cutting-edge, strutless kite that is ideal for...",
	  "link":"http:\/\/www.example.com\/product\/2423",
	  "imageLink":"http:\/\/www.example.com\/img\/2423.jpg",
	  "contentLanguage":"en",
	  "availability":"in stock",
	  "productCategory":"kites",
	  "productSubCategory":"freeride",
	  "condition":"new",
	  "color":"blue",
	  "price":"1040.00",
	  "shippingCosts":"0.00",
	  "currency":"USD",
	  "ean":"921012364125"
      }
   ]
}

4. Submit URL

The product feed must be reached through a link, for example http://www.shopexample.com/kitefinder and should contain the most current data. Check this link and make sure the date matches the date information in your shop.

Then send the link to info@kitefinder.com. We will contact you before your products are visible on Kitefinder Shop.

5. Help

If you need any help, reach us by email any time! We will be in touch as soon as possible.

support@kitefinder.com