The Merchant Search web service returns merchant information (only active merchants are returned) 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.
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 |
Name | Summary |
---|---|
Merchant | Contains a list of merchants.Attributes:
|
//
Name | Summary |
---|---|
Name | The name 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. |
CreditCards | The type of credit cards available to pay with this merchant. |
OtherPaymentMethods | The type other payment methods available with this merchant. |
//
Name | Summary |
---|---|
Summary | The summary for this merchant. |
Logo | The URL and dimension of the merchant logo. |
//
The following is a sample response when you search for the categoryID: 124901 with the service.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <MerchantSearch totalResultsReturned="20" totalResultsAvailable="26" firstResultPosition="1" xmlns="urn:yahoo:prods"> <Merchant id="11653513"> <Name>Rakuten </Name> <Phone></Phone> <Fax></Fax> <Email></Email> <OtherInfo></OtherInfo> <DeliveryCountries> <DeliveryCountry>france</DeliveryCountry> </DeliveryCountries> <MerchantUrl>https://fr.shopping.rakuten.com </MerchantUrl> <Profile> <Summary></Summary> <Logo> <Url>http://r6.kelkoo.com/data/merchantlogos/11653513/logo.jpg</Url> <Width>80</Width> <Height>24</Height> </Logo> </Profile> <ProfileUrl>http://www.kelkoo.fr/mp-11653513-rakuten?affiliationId=96933044</ProfileUrl> <Features/> <CreditCards/> <OtherPaymentMethods/> <Categories> <Category id="125801"> <Name>Accessoires pour téléphone portable</Name> </Category> <Category id="150701"> <Name>CD</Name> </Category> </Categories> </Merchant> </MerchantSearch>