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".