Merchant Search
The Merchant Search web service returns merchant information for selected merchants or a category. This service will help you make your users feel more confident when shopping online by providing detailed information such as store ratings and security features of the stores they shop at.
- Name: Merchant Search
- Version: 2.0
- Path: /V2/merchantsearch
- Schemas: merchantsearch.xsd, common.xsd
- Markets: All markets
Request Parameters
The following parameters can be used with the Merchant Search web service:
| Name | Type | Summary |
|---|---|---|
| aid | string (required) | Your Authentification ID provided to you by Kelkoo. |
| timestamp | string (required) | The number of seconds passed since January 1st 1970. The timestamp is used to sign the URL. |
| hash | string (required) | The hash that will be used to validate your access. |
| merchant | integer | The merchant ID. May contain multiple values separated by commas. Required if catId is not set. |
| category | integer | The category to search in. must be the category ID. Required if comId is not set. |
| enable | string | List of elements to show separated by commas. No value will show all elements. Possible values: store_categories store_creditcards store_details store_features store_payment store_profile store_rating |
| start | integer (optional) default 1 |
The starting result position to return. |
| results | integer (optional) | The number of merchants to return |
Response Elements
Top level Elements
| Name | Summary |
|---|---|
| Merchant | Contains a list of merchants.
Attributes:
|
Merchant Elements
| Name | Summary |
|---|---|
| Name | The name of the merchant. |
| Address | The address of the merchant. |
| Phone | The phone of the merchant |
| Fax | The fax of the merchant |
| The email of the merchant | |
| OtherInfo | Other information about the merchant |
| DeliveryCountries | Delivery countries of the merchant |
| MerchantUrl | The Url to the merchant website. |
| Profile | Contains the summary of the merchant and the URL to his logo. |
| ProfileUrl | The URL to the merchant profile on Kelkoo. |
| Ratings | The rating for this merchant. |
| ReviewUrl | The URL to the merchant review on Kelkoo. |
| CreditCards | The type of credit cards available to pay with this merchant. |
| OtherPaymentMethods | The type other payment methods available with this merchant. |
Profile Elements
| Name | Summary |
|---|---|
| Summary | The summary for this merchant. |
| Logo | The URL and dimension of the merchant logo. |
Ratings Elements
| Name | Summary |
|---|---|
| NumberOfRatings | The number of ratings for this merchant. |
| NumberOfReviews | The number of reviews for this merchant. |
| Recommended | The recommandation for this merchant. |
| RatingsValues | The different ratings and their values.. |
Rating Value Elements
| Name | Summary |
|---|---|
| Label | The rating label. |
| Value | The rating value. |
Sample Response
The following is a sample response when you search for the categoryID: 108101 with the service.
<MerchantSearch firstResultPosition="1" totalResultsAvailable="144" totalResultsReturned="3"> − <Merchant id="258801"> <Name>Charles Tyrwhitt</Name> <MerchantUrl>http://www.ctshirts.co.uk</MerchantUrl> − <Profile> − <Summary> Charles Tyrwhitt hand-make beautifully cut shirts from the very finest materials. We sell formal and casual shirts for men, women and children. Visit us at www.ctshirts.co.uk or phone 0870 777 0333. Alternatively, visit one of our stores at 92 Jermyn Street, SW1 or 43 Bow Lane, EC4. </Summary> − <Logo> − <Url> http://www.kelkoo.co.uk/data/merchantlogos/258801/ctshirts1.gif </Url> <Width>80</Width> <Height>24</Height> </Logo> </Profile> − <ProfileUrl> http://www.kelkoo.co.uk/m-258801-charles-tyrwhitt.html?affiliationId=96913978 </ProfileUrl> − <Ratings> <NumberOfRatings>15</NumberOfRatings> <NumberOfReviews>3</NumberOfReviews> <Recommended>33</Recommended> − <RatingsValues> − <RatingValue> <Label>Ease of Ordering</Label> <Value>3.0</Value> </RatingValue> − <RatingValue> <Label>Customer Care</Label> <Value>2.5</Value> </RatingValue> − <RatingValue> <Label>On-Time Delivery</Label> <Value>3.5</Value> </RatingValue> − <RatingValue> <Label>Overall Store Rating</Label> <Value>3.0</Value> </RatingValue> − <RatingValue> <Label>Availability</Label> <Value>2.5</Value> </RatingValue> </RatingsValues> </Ratings> − <ReviewUrl> http://www.kelkoo.co.uk/maxiMerchantReviews~258801?affiliationId=96913978 </ReviewUrl> <Features/> − <CreditCards> <Item>American Express</Item> <Item>Carte Bleue</Item> <Item>Delta</Item> <Item>Diners Card</Item> <Item>JCB</Item> <Item>Mastercard</Item> <Item>Switch</Item> <Item>Visa</Item> </CreditCards> <OtherPaymentMethods/> − <Categories> − <Category id="100481023"> <Name>Men's Sweaters</Name> </Category> − <Category id="100344123"> <Name>Women's Suits</Name> </Category> − <Category id="107601"> <Name>Men's Accessories</Name> </Category> − <Category id="100331423"> <Name>Women's Outerwear</Name> </Category> − <Category id="100344223"> <Name>Men's Suits</Name> </Category> − <Category id="100332123"> <Name>Men's Tops</Name> </Category> − <Category id="100485923"> <Name>Cufflinks</Name> </Category> − <Category id="100481723"> <Name>Men's Socks</Name> </Category> − <Category id="100331823"> <Name>Men's Outerwear</Name> </Category> − <Category id="100331623"> <Name>Women's Trousers</Name> </Category> − <Category id="100478023"> <Name>Women's Skirts</Name> </Category> − <Category id="100331523"> <Name>Women's Dresses </Name> </Category> − <Category id="109301"> <Name>Men's Shoes</Name> </Category> − <Category id="100331723"> <Name>Women's Tops</Name> </Category> − <Category id="108901"> <Name>Men's Underwear</Name> </Category> − <Category id="100332023"> <Name>Men's Trousers</Name> </Category> </Categories> </Merchant> − <Merchant id="270301"> <Name>Designer Discount</Name> <MerchantUrl>http://www.designerdiscount.co.uk</MerchantUrl> − <Profile> − <Summary> A selection of designer label clothes is available here, including Calvin Klein, Ralph Lauren, Timberland, Tommy Hilfiger and more. Interesting special offers, with some garments at up to 75% off RRP. </Summary> − <Logo> <Url>http://www.kelkoo.co.uk</Url> <Width>80</Width> <Height>24</Height> </Logo> </Profile> − <ProfileUrl> http://www.kelkoo.co.uk/m-.html?affiliationId=96913978 </ProfileUrl> − <Ratings> <NumberOfRatings>0</NumberOfRatings> <NumberOfReviews>0</NumberOfReviews> <Recommended>0</Recommended> − <RatingsValues> − <RatingValue> <Label>Ease of Ordering</Label> <Value>0.0</Value> </RatingValue> − <RatingValue> <Label>Customer Care</Label> <Value>0.0</Value> </RatingValue> − <RatingValue> <Label>On-Time Delivery</Label> <Value>0.0</Value> </RatingValue> − <RatingValue> <Label>Overall Store Rating</Label> <Value>0.0</Value> </RatingValue> − <RatingValue> <Label>Availability</Label> <Value>0.0</Value> </RatingValue> </RatingsValues> </Ratings> − <ReviewUrl> http://www.kelkoo.co.uk/maxiMerchantReviews~?affiliationId=96913978 </ReviewUrl> <Features/> − <CreditCards> <Item>American Express</Item> <Item>Carte Bleue</Item> <Item>Delta</Item> <Item>JCB</Item> <Item>Mastercard</Item> <Item>Solo</Item> <Item>Switch</Item> <Item>Visa</Item> </CreditCards> <OtherPaymentMethods/> − <Categories> − <Category id="100392523"> <Name>Men's Watches</Name> </Category> − <Category id="100481023"> <Name>Men's Sweaters</Name> </Category> − <Category id="100005913"> <Name>Water Sports</Name> </Category> − <Category id="107601"> <Name>Men's Accessories</Name> </Category> − <Category id="100332123"> <Name>Men's Tops</Name> </Category> − <Category id="133501"> <Name>Perfumes &amp;amp; Aftershaves</Name> </Category> − <Category id="108901"> <Name>Men's Underwear</Name> </Category> − <Category id="100332023"> <Name>Men's Trousers</Name> </Category> − <Category id="100481723"> <Name>Men's Socks</Name> </Category> − <Category id="100331823"> <Name>Men's Outerwear</Name> </Category> </Categories> </Merchant> − <Merchant id="328301"> <Name>Sporting-gifts.com Ltd c/o eDirectory</Name> − <MerchantUrl> http://www.edirectory.co.uk/pf/pages/default.asp?recordid=974&amp;amp;mt=Merchant&amp;amp;afid=105749 </MerchantUrl> − <Profile> − <Summary> Full range of current sports books, computer games and videos as well as gifts, prints and figures. Many sports are represented: bowls, boxing, cricket, fishing, football, motor racing, rugby... Pleasant site, easy to order. </Summary> − <Logo> <Url>http://www.kelkoo.co.uk</Url> <Width>80</Width> <Height>24</Height> </Logo> </Profile> − <ProfileUrl> http://www.kelkoo.co.uk/m-.html?affiliationId=96913978 </ProfileUrl> − <Ratings> <NumberOfRatings>0</NumberOfRatings> <NumberOfReviews>0</NumberOfReviews> <Recommended>0</Recommended> − <RatingsValues> − <RatingValue> <Label>Ease of Ordering</Label> <Value>0.0</Value> </RatingValue> − <RatingValue> <Label>Customer Care</Label> <Value>0.0</Value> </RatingValue> − <RatingValue> <Label>On-Time Delivery</Label> <Value>0.0</Value> </RatingValue> − <RatingValue> <Label>Overall Store Rating</Label> <Value>0.0</Value> </RatingValue> − <RatingValue> <Label>Availability</Label> <Value>0.0</Value> </RatingValue> </RatingsValues> </Ratings> − <ReviewUrl> http://www.kelkoo.co.uk/maxiMerchantReviews~?affiliationId=96913978 </ReviewUrl> <Features/> − <CreditCards> <Item>Creditcards (unspecified)</Item> </CreditCards> <OtherPaymentMethods/> − <Categories> − <Category id="164001"> <Name>Basketball</Name> </Category> − <Category id="165101"> <Name>Fitness Equipment</Name> </Category> − <Category id="164901"> <Name>Fishing</Name> </Category> − <Category id="174201"> <Name>Winter Sports</Name> </Category> − <Category id="100376423"> <Name>Glassware</Name> </Category> − <Category id="100230223"> <Name>Cricket</Name> </Category> − <Category id="132401"> <Name>Chocolate</Name> </Category> − <Category id="100353523"> <Name>Miscellaneous</Name> </Category> − <Category id="168001"> <Name>Toys</Name> </Category> − <Category id="165301"> <Name>Darts</Name> </Category> − <Category id="164801"> <Name>Cycling</Name> </Category> − <Category id="142101"> <Name>Pets</Name> </Category> − <Category id="166201"> <Name>Boxing &amp;amp; Martial Arts</Name> </Category> − <Category id="100331723"> <Name>Women's Tops</Name> </Category> − <Category id="100320223"> <Name>Office Supplies</Name> </Category> − <Category id="164201"> <Name>Rugby</Name> </Category> − <Category id="108801"> <Name>Lingerie</Name> </Category> − <Category id="100358623"> <Name>Posters &amp;amp; Art</Name> </Category> − <Category id="100392623"> <Name>Men's Sports Shoes</Name> </Category> − <Category id="100480123"> <Name>Women's Shorts</Name> </Category> − <Category id="166101"> <Name>Tennis</Name> </Category> − <Category id="165201"> <Name>Golf</Name> </Category> − <Category id="100007613"> <Name>Decorations</Name> </Category> − <Category id="100005913"> <Name>Water Sports</Name> </Category> − <Category id="100316823"> <Name>Women's Sports Shoes</Name> </Category> − <Category id="100370523"> <Name>Snooker, Pool and Billiards</Name> </Category> − <Category id="134401"> <Name>House Accessories</Name> </Category> − <Category id="170101"> <Name>Luggage</Name> </Category> − <Category id="100376323"> <Name>Crockery</Name> </Category> − <Category id="100481723"> <Name>Men's Socks</Name> </Category> − <Category id="143101"> <Name>Home Security</Name> </Category> − <Category id="138201"> <Name>Lighting</Name> </Category> − <Category id="100331623"> <Name>Women's Trousers</Name> </Category> − <Category id="100480023"> <Name>Women's T-Shirts &amp;amp; Vests</Name> </Category> − <Category id="137101"> <Name>Furniture Accessories</Name> </Category> − <Category id="108901"> <Name>Men's Underwear</Name> </Category> − <Category id="100485223"> <Name>Pendants &amp;amp; Charms</Name> </Category> − <Category id="164101"> <Name>Football</Name> </Category> − <Category id="139901"> <Name>Kitchen Accessories</Name> </Category> </Categories> </Merchant> − <Warnings> − <Warning> The "start" parameter is not given. The default value "1" is used. </Warning> </Warnings> </MerchantSearch>