Account Management
Username:
Password:
Documentation
Deals Feed Data Format Documentation


PIPE, TAB and CSV File Structure
The data fields for these file formats are in the following order.

CouponID - Our proprietary coupon ID - especially useful in identifying deals that are delivered more than once because they have changed.

MerchantName

MerchantID

Network

Label - The main description text the merchant describes the deal with. May be have been modified to fix typos.

Restrictions - Any information the merchant provides regarding any restrictions relating to how the coupon can be redeemed. May have been modified to fix typos.

CouponCode - If the coupon requires the user to enter a code, it is in this field. Any deal with a code will also contain "coupon" in the DealTypes field.

StartDate

EndDate

Link - This is the actual affiliate link used to go to the merchant's landing page and set the appropriate network cookies with your affiliate info. It requires that you have inserted your affiliate IDs in the Feed Settings. NOTE: For deals marked "coupon" in the DealTypes field (below) this link may be required in order to activate the deal.

DirectLink - This field is deprecated, please ignore it. It remains for backward compatibility.

Categories        (Multiple values are seperatated by commas)

DealTypes        (Multiple values are seperatated by commas)

Image

Status - The status should always be checked, and only "active" deals should be displayed (regardless of expiration date). The status is critical to tell if the deal is currently valid. Values may be: active - Deal is live and may be displayed; deleted - Deal was deleted or otherwise invalidated - ignore other values and remove deal; suspended - The merchant was deactivated in the network so this deal may not be paybale; or expired - The deal expired normally.

LastUpdated - When this deal was last modified in the system.

ErrorReportURL   (Optional, Turn on/off on Manage Feeds page)

ChangeAudit      (Optional, Turn on/off on Manage Feeds page)

Created      (When this deal was added to the system)

Country      (Countries of the deal)

Price      (Product Price, not applied to all deals)

List Price      (Product List Price, not applied to all deals)

Discount      (Product Discount, not applied to all deals)

Percent      (Product Discount Percent, not applied to all deals)

City      (Local Deal Data: City)

State      (Local Deal Data: State)

ZipCode      (Local Deal Data: ZipCode)

Address      (Local Deal Data: Address)

Business Name      (Local Deal Data: Business Name)

Business Url      (Local Deal Data: Business URL)

Title 2      (Local Deal Data: Title2)

Expiration Date      (Local Deal Data: Expiration, a string containing information about when this deal must be redeemed by)

Min Purchase      (Local Deal Data: Min Purchase, minumum number of deals you are required to purchase)

Max Purchase      (Local Deal Data: Max Purchase, maximum number of deals you are allowed to purchase)

Limited Qty      (Local Deal Data: Limited Qty, true or false if the deal limited to a certain quantity)

Region      (Local Deal Data: Region, this would be the GroupOn, LivingSocial, etc.. city that the deal is filed in)

Local Deals Note: Besides the fields above specificly referenced as Local Deal Data the Price, List Price, Percent and Discount fields contain information related to local deals.



XML Feed Structure

<deals>

<item>

<couponid>int</couponid>

<merchantid>int</merchantid>

<merchantname>string</merchantname>

<network>string</network>

<label>string</label>

<restrictions>string</restrictions>

<couponcode>string</couponcode>

<link>string</link>

<directlink>string</directlink>

<startdate>YYYY-MM-DD HH:MM TMZ</startdate>

<enddate>YYYY-MM-DD HH:MM TMZ</enddate>

<image>string</image>

<dealtypes>

<type>string</type>

</dealtypes>

<categories>

<category>string</category>

</categories>

<status>status</status>

<lastupdated>YYYY-MM-DD HH:MM TMZ</lastupdated>

<errorreporturl>string</errorreporturl>

<changeaudit>string</changeaudit>

<price>string</price>

<listprice>string</listprice>

<discount>string</discount>

<percent>string</percent>

<local>

<city>string</city>

<state>string</state>

<zipcode>string</zipcode>

<address>string</address>

<businessname>string</businessname>

<businessurl>string</businessurl>

<title2>string</title2>

<expirationdate>string</expirationdate>

<minpurchase>int</minpurchase>

<maxpurchase>int</maxpurchase>

<limitedqty>bool</limitedqty>

<region>string</region>

</local>

</item>

</deals>



© 2012 ForMeToCoupon.com