getMerchants - Retrieves the status of each merchant in each network. Also useful for retrieving the system ID of each merchant program.
getCategories - Retrieves the list of categories and their filter codes for use in getMerchants
getRss - Retrieves merchant deals ("coupons") in RSS format.
getChanges - Retrieves details about changes to a deal.
getShippingDeadlines - Retrieves all known holiday shipping deadlines for merchant products and offers.
Only the "key" argument is mandatory.
The "incremental=1" argument is especially useful - it will only return items that have changed since your last request.
| GET Parameter | Characteristics | Description |
| key | Required | Your developer key, this value is available in the Manage Feeds page . |
| incremental | optional 1 |
The system will always remember your last incremental download. Including this option and setting it to 1 will download only items added or modified since your last download. (Setting it to any value is equivalent to setting it to 1, for backward compatibility reasons.) |
| sincedate | Optional Date/Time YYYY-MM-DD-HH:MM ZZZ 2007-10-01-08:00 |
Only return items added or modified since this date. (Time is optional - defaults to midnight, timezone defaults to your web interface setting.) |
| activedatestart | Optional Date YYYY-MM-DD 2007-10-01 |
Include all coupons that begin on or after this date. |
| activedateend | Optional |
Include all coupons that begin on or before this date. |
| expiredatestart | Optional |
Include all coupons that expire on or after this date. |
| expiredateend | Optional |
Include all coupons that expire on or before this date. |
| network | Optional |
Return only deals from a particular network. Use the network codes found here. |
| merchantids | Optional |
Return only deals from a particular merchant. Referer to your Merchant ID List for acceptable values to filter by. If you do not specify a merchantids value deals will be returned from all of your selected merchants. |
| categoryids | Optional |
Return only deals from a particular category or categories. Referer to the Category List for acceptable filtering values. |
| dealtype | Optional |
Return only deals from of a particular type. Acceptable values are listed below. coupon |
| country | Optional |
Return only deals from of a particular country. Acceptable values are 'us' and 'uk'. |
Use this service call to access this feed over HTTP, select your service format on the Manage Feeds control panel. Only merchants choosen on the Manage Merchants control panel are returned.
Only the "key" argument is mandatory.
The "incremental=1" argument is especially useful - it will only return items that have changed since your last request.
| GET Parameter | Characteristics | Description |
| key | Required | Your developer key, this value is available in the Manage Feeds page . |
| incremental | optional 1 |
The system will always remember your last incremental download. Including this option and setting it to 1 will download only items added or modified since your last download. (Setting it to any value is equivalent to setting it to 1, for backward compatibility reasons.) |
Use this service call to access the list of available categories in the feed.
Only the "key" argument is mandatory.
| GET Parameter | Characteristics | Description |
| key | Required | Your developer key, this value is available in the Manage Feeds page or use the Base URL value above. |
Use this service call to get details information about changes to a particular deal.
| GET Parameter | Characteristics | Description |
| key | Required | Your developer key, this value is available in the Manage Feeds page or use the Base URL value above. |
| couponid | Required | The CouponID of the deal you would like more information on. |
Use this service call to retrieve merchant deals in RSS format.
Only the "key" argument is mandatory.
| GET Parameter | Characteristics | Description |
| key | Required | Your developer key, this value is available in the Manage Feeds page . |
| incremental | optional 1 |
The system will always remember your last incremental download. Including this option and setting it to 1 will download only items added or modified since your last download. (Setting it to any value is equivalent to setting it to 1, for backward compatibility reasons.) |
| network | Optional |
Return only deals from a particular network. Use the network codes found here. |
| merchantids | Optional |
Return only deals from a particular merchant. Referer to your Merchant ID List for acceptable values to filter by. If you do not specify a merchantids value deals will be returned from all of your selected merchants. |
| sincedate | Optional Date/Time YYYY-MM-DD-HH:MM ZZZ 2007-10-01-08:00 |
Only return items added or modified since this date. (Time is optional - defaults to midnight, timezone defaults to your web interface setting.) |
| activedatestart | Optional Date YYYY-MM-DD 2007-10-01 |
Include all coupons that begin on or after this date. |
| activedateend | Optional |
Include all coupons that begin on or before this date. |
| expiredatestart | Optional |
Include all coupons that expire on or after this date. |
| expiredateend | Optional |
Include all coupons that expire on or before this date. |
| categoryids | Optional |
Return only deals from a particular category or categories. Referer to the Category List for acceptable filtering values. |
| dealtype | Optional |
Return only deals from of a particular type. Acceptable values are listed below. coupon |
Use this service call to access information about holiday shipping deadlines.
Only the "key" argument is mandatory.
| GET Parameter | Characteristics | Description |
| key | Required | Your developer key, this value is available in the Manage Feeds page or use the Base URL value above. |