Blog Home | Forum Home | iCodes UK | iCodes US


Webservices v1 Requests

RequestType Parameters [optional]
Merchant username SubscriptionID merchant [deselected_merchants]
MerchantList username SubscriptionID browse or search [deselected_merchants]
CategoryList username SubscriptionID
VoucherCode username SubscriptionID merchant vouchercode [deselected_merchants]
AllVoucherCodes username SubscriptionID [search] [category] [network] [orderby] [deselected_merchants]
NewVoucherCodes username SubscriptionID [hours] [limit] [network] [orderby] [deselected_merchants]
ExpiringVoucherCodes username SubscriptionID [hours] [limit] [orderby] [deselected_merchants]
MerchantWithVoucherCodes username SubscriptionID merchant [orderby] [deselected_merchants]
MerchantListWithVoucherCodes username SubscriptionID browse or search [orderby] [deselected_merchants]
AllOffers username SubscriptionID category [search] [network] [orderby] [deselected_merchants]
NewOffers username SubscriptionID [hours] [limit] [network] [orderby] [deselected_merchants]
ExpiringOffers username SubscriptionID [hours] [limit] [orderby] [deselected_merchants]
MerchantWithOffers username SubscriptionID merchant [orderby] [deselected_merchants]
MerchantListWithOffers username SubscriptionID browse or search [orderby] [deselected_merchants]
 

Example Requests: (examples will not include all merchants and will use our id’s)

Category List
http://webservices.icodes.co.uk/feed.xml?username=YOUR-USERNAME&SubscriptionID=YOUR-SUBID&RequestType=CategoryList

All Voucher Codes
http://webservices.icodes.co.uk/feed.xml?username=YOUR-USERNAME&SubscriptionID=YOUR-SUBID&RequestType=AllVoucherCodes

All Voucher Codes from Webgains
http://webservices.icodes.co.uk/feed.xml?username=YOUR-USERNAME&SubscriptionID=YOUR-SUBID&RequestType=AllVoucherCodes&network=webgains

All Voucher Codes in the ‘Clothing and Footwear’ Category
http://webservices.icodes.co.uk/feed.xml?username=YOUR-USERNAME&SubscriptionID=YOUR-SUBID&RequestType=AllVoucherCodes&category=clothing and footwear

All Voucher Codes containing “free delivery” in the Description.
http://webservices.icodes.co.uk/feed.xml?username=YOUR-USERNAME&SubscriptionID=YOUR-SUBID&RequestType=AllVoucherCodes&search=”free delivery”

New Voucher Codes added in the last 48 hours and limited to show 10
http://webservices.icodes.co.uk/feed.xml?username=YOUR-USERNAME&SubscriptionID=YOUR-SUBID&RequestType=NewVoucherCodes&hours=48&limit=10&orderby=id

Expiring Voucher Codes in the next 48 hours and limited to show 10
http://webservices.icodes.co.uk/feed.xml?username=YOUR-USERNAME&SubscriptionID=YOUR-SUBID&RequestType=ExpiringVoucherCodes&hours=48&limit=10&orderby=expiry_date

Currys voucher codes
http://webservices.icodes.co.uk/feed.xml?username=YOUR-USERNAME&SubscriptionID=YOUR-SUBID&RequestType=MerchantWithVoucherCodes&merchant=currys

Merchants (with voucher codes) beginning with ‘A’
http://webservices.icodes.co.uk/feed.xml?username=YOUR-USERNAME&SubscriptionID=YOUR-SUBID&RequestType=MerchantListWithVoucherCodes&browse=a

Merchants (with voucher codes) search for ‘Furniture’
http://webservices.icodes.co.uk/feed.xml?username=YOUR-USERNAME&SubscriptionID=YOUR-SUBID&RequestType=MerchantListWithVoucherCodes&search=furniture

Merchants search for ‘Furniture’
http://webservices.icodes.co.uk/feed.xml?username=YOUR-USERNAME&SubscriptionID=YOUR-SUBID&RequestType=MerchantList&search=furniture

To order the feed include either…
&orderby=start_date
&orderby=expiry_date
&orderby=max_start_date
&orderby=min_expiry_date
&orderby=id

Offer Requests follow the same as above apart from AllOffers must be requested by category.

AllVoucherCodes Requests are limited to 6 calls per 24 hours if used without parameters

To include all unjoined and rejected merchants… (iCodes ID’s or Merchant URL’s will be used on all merchants you are NOT joined to.)
&deselected_merchants=on

All merchants will shortly be returned within your selected categories.

Leave a Reply

Recent Comments