NWS API (SOAP) help for parameters in requests and returns. [Last modified: 11/18/2005]

• General settings for request parameters
• Request parameters for main search or product browsing (Browse.php)
• Request parameters for getting products by product ID list (Item.php)
• Request parameters for reaching hot deals (Deals.php)
• General settings for return parameters
• Return parameters for main search or product browsing (Browse.php)
• Return parameters for getting products by product ID list (Item.php)
• Return parameters for reaching hot deals (Deals.php)

"clientid" is either your login name on Netoon.com, or your unique numerical ID associated with the name. You may look up your clientid and privateid in your NWS profiles.

Your clientid will also be used as your affiliate tracking ID, if you joined Netoon as revenue share partner.

If a clientid doesn't match a privateid, a default 'testid' will be used and you will not be credit for revenue share.

linktype = "1". Direct link. Direct link links your customers to vender's website directly. This type of link doesn't earn you commissions upon referral. Direct links are only provided under specific agreement. Please email support@netoon.com for details.

linktype = "2". Netoon link. Netoon links look like: http://netoon.com/redirect2.php?siteid=xxx&urlid=yyy&s1=clientid
This is the default and suggested link type. When any users click the link and make a purchase of participated products, you share revenue with Netoon.

linktype = "3". Your link with your Netoon ID. If you don't want visitors see links of netoon.com, or if you'd like to do further actions such as tracking user browsing behaviors, you can set linktype=3, and Netoon will return siteid=xxx&urlid=yyy rather than a full URL. You'd develop your code for proper redirection. A sample code is included in the demo package as nbounce.php.

linktype = "4". Your link without your Netoon ID.

Note: We understand that many customers would like to use NWS as personal deal discovery tool, however NWS is designed for websites that would like to reuse Netoon's data to enrich their web content. Personal users please refer to our upcoming Premium Shopping Service.

Note: Please note that Netoon prohibits change, remove and edit, but not restrict to, the URL's, affiliate IDs and sub-affiliate IDs that comes from Netoon. You agreed with this before you registered NWS.

Please use "0" to specifically search in all sites, and use "-1" to search in your pre-set websites through NWS settings.

Please note that not all sites have affiliate program. It's your choice to filter content from any websites.

If page number less than 0, i.e. -1, the server will return a radom page.

Note: this value could be changed by server if you sent a number either less than 0 or greater than total result pages.

^* All parameter types are 'string', but you can always submit an number without a quote mark. For exapmle, in most cases, using $proxy->searchItemData(array('clientid'=>'5001')) is equal to $proxy->searchItemData(array('clientid'=>5001))

^* Please use 'true' instead true.

^* All parameters are case sensitive.

Back to top

Main search or browse (Browse.php) -- request values

1. order by rebate, instant discount, clearance items first, then after rebate price low to high
2. order by rebate, instant discount, clearance items first, then after rebate price high to low
3. order by after rebate price low to high
4. order by after rebate price hight to low
5. order by descending time that last price drop or rebate occurred
6. order by percent jump
7. order by percent drop
8. order by before rebate price low to high
9. order by before rebate price high to low

Please note that "" is different with "0" because one may earn money after rebate for some products such as cell phones.

Please note that to set higher price boundary to a very small number could be used as "filler finder". Filler finder could be used as padding for coupon or free shipping.

Back to top

Get products by a list of item ID (Item.php) -- request values

Back to top

Get hotdeals (Deals.php) -- request values

Please note that some deals may be "active" for one day only. It's your choice to let users find the "dead" ones or not.

Back to top

^* All return results have a array named "SearchFor". All submitted values are changed to appropriate format/values if not meet the requirements.

Deprecated

Deprecated

Back to top

Main search or browse (Browse.php) -- return values

For more information, refer to Item.php

Note: Netoon may fail to retrieve rebate amount for certain product.

Note: this is NOT a true/false value. It's string of "true" or "false".

Note: this is NOT a true/false value. It's string of "true" or "false".

Note: this is NOT a true/false value. It's string of "true" or "false".

Note: this is NOT a true/false value. It's string of "true" or "false".

Note: this is NOT a true/false value. It's string of "true" or "false".

Note: this is NOT a true/false value. It's string of "true" or "false".

Back to top

Get products by a list of item ID (Item.php) -- return values

Back to top

Get hotdeals (Deals.php) -- return values

Note: Netoon may fail to retrieve rebate amount for certain product.

Note: this is NOT a true/false value. It's string of "true" or "false".

Note: this is NOT a true/false value. It's string of "true" or "false".

Back to top