Change Log - v2 (Legacy)
2023-10-24
Updates
Removed a deprecated input parameter, all, for getDeals.
Deprecated the Categories output field value for getDeals in favor of the CategoriesV2 output field value.
2022-01-22
Updates
Migrated data from Apiary for historical accuracy.
V2 Overview
V2 of our API calls gives our users five benefits:
Faster than V1
JSON format is now available
Date format has been standardized to ISO 8601 date format
New features will only be added to V2 in the future
Improved data structure
Date Change Example:
Old Date Format: 2012-01-24 19:43 PST
New Date Format: 2012-01-24T19:43:58-08:00
Unneccessary Fields Removed:
Dropped the "Error Reporting URL" field
Dropped the "Change Audit" field
Dropped the "Country" field, this information is available in the getMerchants feed
Dropped the "NetworkID" field, this information is available in the getMerchants feed
New Fields Added:
Added "Threshold" field
Added "Rating" field
Added "SkimlinksURL" field
New Parameter:
You can specify the feed format in the api call with "&format=(XML|JSON|PIPE|TAB|CSV)"
Example API V2 Calls:
https://services.fmtc.co/v2/getDeals?key=&merchantids=6&format=XML&view=1
https://services.fmtc.co/v2/getMerchants?key=&format=XML
https://services.fmtc.co/v2/getCategories?key=&format=XML
https://services.fmtc.co/v2/getTypes?key=&format=XML
https://services.fmtc.co/v2/getLogos?key=
Complete V2 Changelist
This is a list of changes made to the V2 of our API from V1.
All Calls
Added JSON format support to all calls
Country values are now in standard two-character format. "usa" is now "US", "canada" is now "CA"
All dates are now in the ISO 8601 date format.
getDeals - All Formats
Changed "startdate" value to ISO 8601 date format.
Changed "enddate" value to ISO 8601 date format.
Changed "created" value to ISO 8601 date format.
Changed "lastupdated" value to ISO 8601 date format.
getDeals - XML Format
Changed tag name from "price" to "saleprice".
Changed tag name from "listprice" to "wasprice".
Added tag "skimlinks", this is your skimlinks url if you have this feature enabled.
Added tag "threshold", this is the order value threshold that must be met to redeem a deal.
Added tag "rating", this is a simple rating system that can be used to order deals.
Removed tag "changeaudit", this information can be obtained from the getChanges call.
Removed tag "errorreporturl"
Removed tag "startdate_date", this field only appeared when option "Include Time Breakdown Fields" is enabled.
Removed tag "startdate_time", this field only appeared when option "Include Time Breakdown Fields" is enabled.
Removed tag "enddate_date", this field only appeared when option "Include Time Breakdown Fields" is enabled.
Removed tag "enddate_time", this field only appeared when option "Include Time Breakdown Fields" is enabled.
Removed tag "lastupdated_date", this field only appeared when option "Include Time Breakdown Fields" is enabled.
Removed tag "lastupdated_time", this field only appeared when option "Include Time Breakdown Fields" is enabled.
Removed tag "created_date", this field only appeared when option "Include Time Breakdown Fields" is enabled.
Removed tag "created_time", this field only appeared when option "Include Time Breakdown Fields" is enabled.
Changed element "local", see getDeals documentation for new element structure.
getDeals - CSV, PIPE & Tab Format
The fields have been reordered to group similar fields together.
Fields that may have appeared only when their option was enabled, now those fields are in the feed all the time. They will still only be populated when the related option is enabled.
Changed column header from "price" to "saleprice".
Changed column header from "Link" to "AffiliateURL"
Changed column header from "DirectLink" to "DirectURL"
Added field "SkimlinksURL".
Added field "Rating".
Added field "SalePrice".
Added field "WasPrice".
Added field "DollarsOff".
Added field "PercentOff".
Added field "SaleThreshold".
Added field "Fine Print" (local data).
Removed field "ErrorReportURL".
Removed field "ChangeAudit".
Removed field "Start-Date".
Removed field "Start-Time".
Removed field "End-Date".
Removed field "End-Time".
Removed field "Created-Date".
Removed field "Created-Time".
Removed field "LastUpdated-Date".
Removed field "LastUpdated-Time".
Removed field "Country".
Removed field "Title2" (local data).
Removed field "MinPurchase" (local data).
Removed field "MaxPurchase" (local data).
Removed field "LimitedQty" (local data).
getMerchants - XML Format
Changed tag name "id" to "merchantid".
Changed tag name "link" to "affiliateurl".
Changed tag name "skimlinks" to "skimlinksurl".
Changed "status" field value "deleted" to "inactive".
Changed "status" field value "expired" to "inactive".
Changed value of "lastupdated" to ISO 8601 date format.
Changed value of "created" to ISO 8601 date format.
Added tag "mobilecertified".
Added tag "primarycategory".
Added tag "primarycountry".
Added tag "selectedstatus".
Added tag "relationshipstatus".
Added tag "logo88x31", this field was previously only in the feed when Logos was enabled.
Added tag "logo120x60", this field was previously only in the feed when Logos was enabled.
Added tag "custommerchantlogo", this field was previously only in the feed when Merchant Custom Fields enabled.
Added tag "custommerchantdescription", this field was previously only in the feed when Merchant Custom Fields was enabled.
Removed tag "googlecheckout".
Removed tag "amazonpayments".
Removed tag "billmelater".
Removed tag "wupay".
Removed tag "paypal".
Removed tag "vme".
Removed tag "dualmerchants", this tag is replaced by the "relatedmerchants" element.
Added element "relatedmerchants", see getMerchants documentation for the element structure.
Added element "paymentoptions", each payment type is represented by its unique slug value.
getMerchants - CSV, PIPE & TAB Format
CouponID
The fields have been reordered to group similar fields together.
Fields that may have appeared only when their option was enabled, now those fields are in the feed all the time. They will still only be populated when the related option is enabled.
Added field "MobileCertified".
Added field "PrimaryCategory", this field was previously only in the feed when "Include Merchant Primary Category" was enabled .
Added field "SkimlinksURL", this field was previously only in the feed when Skimlinks was enabled .
Added field "Logo88x31", this field was previously only in the feed when logos were enabled .
Added field "Logo120x60", this field was previously only in the feed when logos were enabled .
Added field "CustomLogo", this field was previously only in the feed when Merchant Custom Fields enabled.
Added field "CustomDescription", this field was previously only in the feed when Merchant Custom Fields enabled.
Added field "SpecialPaymentOptions", each payment type is represented by its unique slug value, comma seperated.
Removed field "GoogleCheckout".
Removed field "AmazonPayments".
Removed field "BillMeLater".
Removed field "WUPay".
Removed field "PayPal".
Removed field "VMe".
Changed the fields assoicated with "local" data, see the getDeals documentation for the updated field order.
getCategories - All Formats
Remove field "id".
Changed field name "filter" to "slug".
getTypes- All Formats
Changed field name "filter" to "slug".
getNetworks - All Formats
Changed field name "id" to "slug".
Added field "countries" to indicate what country this network has merchants in.
getChanges - All Formats
Added additional change types, see getChanges documentation for a full list of change types.
Added field "changeid".
Changed field name "changedate" to "date".
Changed field name "changetype" to "type".