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.