XML Web Services Requests

All Categories > Tutorials

Default Settings

Merchants selected as JOINED will contain YOUR affiliate ID's.
Merchants selected as NOT JOINED will contain OUR affiliate ID's or use direct merchant url.
Merchants selected as REJECTED and SUSPENDED will not be included.

Settings with &Relationship=joined

Merchants selected as JOINED will contain YOUR affiliate ID's.
Merchants selected as NOT JOINED will not be included.
Merchants selected as REJECTED and SUSPENDED will not be included.

Settings with &Relationship=all *Paid Subscription Only

Merchants selected as JOINED will contain YOUR affiliate ID's.
Merchants selected as NOT JOINED will contain OUR affiliate ID's or use direct merchant url.
Merchants selected as REJECTED and SUSPENDED will use direct merchant url.

Valid RequestTypes:

Codes
Offers
MerchantList
CategoryList
NetworkList

Codes and Offers:

Valid Action -> Full
Valid Action -> Expiring [Sort]
Valid Action -> New [-> valid query -> ShortDated] [Hours] [Sort]
Valid Action -> All [Sort]
Valid Action -> PostDated [Sort]
Valid Action -> Category -> valid query -> category or category_id [Sort]
Valid Action -> Merchant -> valid query -> merchant or mid [Sort]
Valid Action -> Search -> valid query -> keywords [CategoryId] [Mid] [Sort]
Valid Action -> Icid -> valid query -> Icid

MerchantList:

Valid Action -> Full
Valid Action -> Category -> valid query -> category_id[GroupBy]
Valid Action -> Search -> valid query -> merchant -> string -> [0-9][GroupBy]
Valid Action -> All[GroupBy]
Valid Action -> Codes -> valid query -> category_id[GroupBy]
Valid Action -> Offers -> valid query -> category_id[GroupBy]
Valid Action -> Icid -> valid query -> Icid

Sort Parameters: (Sorting the feed order)

&Sort=StartDateLow
&Sort=StartDateHigh
&Sort=ExpiryDateLow
&Sort=ExpiryDateHigh
&Sort=id

CategoryId Parameters: (search within a single category or multiple categories seperated by commas)
&CategoryId=category_id,category_id

Mid Parameters: (search within a single merchant or multiple merchants seperated by commas)
&Mid=mid,mid

GroupBy Parameters: (group merchants on multple networks with exact name formats)
&GroupbBy=Merchant

Relationship Parameters:
&Relationship=joined (include only what you have selected as joined)
&Relationship=all (include joined / not joined / rejected / suspended) *Paid Subscription Only

Network Parameters: (to include all networks do not use this parameter)
&Network=linkshare,commission_junction,webgains,affiliate_window

Hours Parameters: (to include only the last xx hours, for use with RequestType=New)
&Hours=xx

Paging Parameters: (page number and amount per page)
&Page=xx
&PageSize=xx: (maximum 50) (default 20)

Please Note: The examples are restricted to a single network.

Example Full Requests: (limited to 20 per day)

Request all codes for your joined merchants in a single feed
http://webservices.icodes.co.uk/ws2.php?UserName=pagerank10&SubscriptionID=5a5eab21ca2a8fef4af5e35709ecca15&RequestType=Codes&Action=Full&Relationship=joined

Request all offers for your joined merchants in a single feed
http://webservices.icodes.co.uk/ws2.php?UserName=pagerank10&SubscriptionID=5a5eab21ca2a8fef4af5e35709ecca15&RequestType=Offers&Action=Full&Relationship=joined

Request all your joined merchants in a single feed
http://webservices.icodes.co.uk/ws2.php?UserName=pagerank10&SubscriptionID=5a5eab21ca2a8fef4af5e35709ecca15&RequestType=MerchantList&Action=Full&Relationship=joined

Example Paged Requests: (unlimited requests per day)

Request all merchants begining with the letter 'A'
http://webservices.icodes.co.uk/ws2.php?UserName=pagerank10&SubscriptionID=5a5eab21ca2a8fef4af5e35709ecca15&RequestType=MerchantList&Action=Search&Query=a&GroupBy=Merchant

Request all merchants with codes begining with the letter 'A'
http://webservices.icodes.co.uk/ws2.php?UserName=pagerank10&SubscriptionID=5a5eab21ca2a8fef4af5e35709ecca15&RequestType=Codes&Action=Merchants&Query=a&GroupBy=Merchant

Request all merchants within category 4
http://webservices.icodes.co.uk/ws2.php?UserName=pagerank10&SubscriptionID=5a5eab21ca2a8fef4af5e35709ecca15&RequestType=MerchantList&Action=Category&Query=4&GroupBy=Merchant

Request all merchants with codes within category 4
http://webservices.icodes.co.uk/ws2.php?UserName=pagerank10&SubscriptionID=5a5eab21ca2a8fef4af5e35709ecca15&RequestType=MerchantList&Action=Codes&Query=4&GroupBy=Merchant

Request all codes within category 4
http://webservices.icodes.co.uk/ws2.php?UserName=pagerank10&SubscriptionID=5a5eab21ca2a8fef4af5e35709ecca15&RequestType=Codes&Action=Category&Query=4

Request post dated codes
http://webservices.icodes.co.uk/ws2.php?UserName=pagerank10&SubscriptionID=5a5eab21ca2a8fef4af5e35709ecca15&RequestType=Codes&Action=PostDated&Sort=StartDateHigh

Request expiring codes
http://webservices.icodes.co.uk/ws2.php?UserName=pagerank10&SubscriptionID=5a5eab21ca2a8fef4af5e35709ecca15&RequestType=Codes&Action=Expiring&Sort=ExpiryDateLow

Request codes by Icid
http://webservices.icodes.co.uk/ws2.php?UserName=pagerank10&SubscriptionID=5a5eab21ca2a8fef4af5e35709ecca15&RequestType=Codes&Action=Icid&Query=1234,2345

Request new codes added in the last 48 hours
http://webservices.icodes.co.uk/ws2.php?UserName=pagerank10&SubscriptionID=5a5eab21ca2a8fef4af5e35709ecca15&RequestType=Codes&Action=New&Hours=48

Request codes for merchant Comet
http://webservices.icodes.co.uk/ws2.php?UserName=pagerank10&SubscriptionID=5a5eab21ca2a8fef4af5e35709ecca15&RequestType=Codes&Action=Merchant&Query=2717

Search all codes containing the keyword 'dvd' in the title or description
http://webservices.icodes.co.uk/ws2.php?UserName=pagerank10&SubscriptionID=5a5eab21ca2a8fef4af5e35709ecca15&RequestType=Codes&Action=Search&Query=dvd

Request category list
http://webservices.icodes.co.uk/ws2.php?UserName=pagerank10&SubscriptionID=5a5eab21ca2a8fef4af5e35709ecca15&RequestType=CategoryList

Request network list
http://webservices.icodes.co.uk/ws2.php?UserName=pagerank10&SubscriptionID=5a5eab21ca2a8fef4af5e35709ecca15&RequestType=NetworkList



UK Home | US Home | Forum | UK Register | US Register | Support