The getMerchants Feed Deal Merchants Endpoint contains information to help you map our merchants to your own internal system, as well as provide you with robust data about the merchant, the kinds of products it sells, where it ships to, and more. Only merchants you have selected will be included in this feed.
...
Term | Abbreviation | Definition |
|---|---|---|
API Endpoints
getMerchantsDeal Merchants
Description: Information to help gather information on all the merchants inside of our system.
Example Request: https://s3.fmtc.co/api/v3/deals-merchants?api_token=API_KEY
...
Name | Value(s) | Description | Required | Default | ||||
|---|---|---|---|---|---|---|---|---|
api_token | APIKEY | API key for authentication, available on the API Keys & Calls page.(https://account.fmtc.co/cp/api_keys) | Yes | N/A, must always be provided | ||||
format | String XML, JSON, CSV, TAB, or PIPE | Choose the feed format you would like returned. | No | JSONall | 0,1 | Return all merchants rather than the selected merchants | No | 0 |
incremental | Number | The amount of time from the previous call and to include only items that have changed since this time. For Example, setting this value to 60 will send back all changes in the past 60 minutes from the time of this call. | No | 0 | ||||
premium | 0,1 | Select premium merchants | No | 0 | ||||
merchantids | Number(s) | Return only deals from a particular merchant. If you do not specify a merchantids value deals will be returned from all of your selected merchants. | No | null | ||||
programid | Number | Return only merchants from a particular network. Referer to the Network List for valid network slug values. | No | null | ||||
networkid | Number | Return only deals from a particular network. | No | null | ||||
country | String. Two-Letter Country Code | Return only merchants with a particular Primary Country. | null | |||||
sincedate | Date (YYYY-MM-DD) | Only return items added or modified since this date. The time pasted will be treated as US Pacific Time. | No | null | ||||
page_size | Number 0 - 1000 | Size of each page for the results of this call. | No | 30 | ||||
deactivated | 0,1 | Include deactivated merchants | No | 0 | ||||
deleted | 0,1 | Include deleted merchants | No | 0 |
Implementation
Response Elements
...
Here is an example of a JSON Response from the getMerchants Deal Merchants endpoint.
| Code Block |
|---|
{
"data": [
{
"id": 13,
"master_merchant_id": 13,
"name": "AreYouGame.com",
"homepage": "https://www.areyougame.com/",
"premium": 0,
"network_id": 3,
"program_id": "247913",
"dual_merchants": [],
"status": "active",
"created": "2007-01-01T08:00:00.000000Z",
"last_updated": "2022-05-01T13:07:59.000000Z",
"selected_status": 1,
"relationship_status": 1,
"affiliate_url": "https://www.dpbolvw.net/click-TestCJP-55431",
"skimlinks_url": "https://go.redirectingat.com/?id=1&xs=1&xcust=4mtc&url=https%3A%2F%2Fwww.areyougame.com%2F",
"freshreach_url": "https://freshreach.co/click.php?m=13&cid=FMTC&uid=9107&sid=4mtc",
"fmtc_url": "https://fmtc.co/m/13/",
"primary_country": "US",
"shiptocountries": [
"US",
"CA",
"UK",
"AU"
],
"categories": [
"toys-games"
],
"skimlinks_id": 645,
"network_notes": "",
"rep_name": "Heather Mannion",
"rep_email": "affiliates@areyougame.com ",
"rep_phone": "",
"apo_fpo_shipping": 0,
"curbside_pickup": 0,
"mobile_certified": 0
}
],
} |
...
Here is an example of an XML Response from the getMerchants Deal Merchants endpoint.
| Code Block |
|---|
<!-- Created with Liquid Studio 2019 (https://www.liquid-technologies.com) -->
<results>
<data>
<merchant>
<id>13</id>
<master_merchant_id>13</master_merchant_id>
<name>AreYouGame.com</name>
<homepage>https://www.areyougame.com/</homepage>
<premium>0</premium>
<network_id>3</network_id>
<program_id>247913</program_id>
<dual_merchants/>
<status>active</status>
<created>2007-01-01 08:00:00</created>
<last_updated>2022-05-01 13:07:59</last_updated>
<selected_status>1</selected_status>
<relationship_status>1</relationship_status>
<affiliate_url>https://www.dpbolvw.net/click-TestCJP-55431</affiliate_url>
<skimlinks_url>https://go.redirectingat.com/?id=1&xs=1&xcust=4mtc&url=https%3A%2F%2Fwww.areyougame.com%2F</skimlinks_url>
<freshreach_url>https://freshreach.co/click.php?m=13&cid=FMTC&uid=9107&sid=4mtc</freshreach_url>
<fmtc_url>https://fmtc.co/m/13/</fmtc_url>
<primary_country>US</primary_country>
<shiptocountries>
<country>US</country>
<country>CA</country>
<country>UK</country>
<country>AU</country>
</shiptocountries>
<categories>
<category>toys-games</category>
</categories>
<skimlinks_id>645</skimlinks_id>
<network_notes/>
<rep_name>Heather Mannion</rep_name>
<rep_email>affiliates@areyougame.com </rep_email>
<rep_phone/>
<apo_fpo_shipping>0</apo_fpo_shipping>
<curbside_pickup>0</curbside_pickup>
<mobile_certified>0</mobile_certified>
</merchant>
</data>
</results> |
...
Here is an example of a CSV Response from the getMerchants Deal Merchants endpoint.
| Code Block |
|---|
id,master_merchant_id,name,homepage,premium,network_id,program_id,dual_merchants,status,created,last_updated,selected_status,relationship_status,affiliate_url,skimlinks_url,freshreach_url,fmtc_url,primary_country,shiptocountries,categories,skimlinks_id,network_notes,rep_name,rep_email,rep_phone,apo_fpo_shipping,curbside_pickup,mobile_certified 13,13,AreYouGame.com,https://www.areyougame.com/,0,3,247913,,active,"2007-01-01 08:00:00","2022-05-01 13:07:59",1,1,https://www.dpbolvw.net/click-TestCJP-55431,https://go.redirectingat.com/?id=1&xs=1&xcust=4mtc&url=https%3A%2F%2Fwww.areyougame.com%2F,https://freshreach.co/click.php?m=13&cid=FMTC&uid=9107&sid=4mtc,https://fmtc.co/m/13/,US,"US, CA, UK, AU",toys-games,645,,"Heather Mannion","affiliates@areyougame.com ",,0,0,0 |
...
Here is an example of a TAB Response from the getMerchants Deal Merchants endpoint.
| Code Block |
|---|
id master_merchant_id name homepage premium network_id program_id dual_merchants status created last_updated selected_status relationship_status affiliate_url skimlinks_url freshreach_url fmtc_url primary_country shiptocountries categories skimlinks_id network_notes rep_name rep_email rep_phone apo_fpo_shipping curbside_pickup mobile_certified 13 13 AreYouGame.com https://www.areyougame.com/ 0 3 247913 active "2007-01-01 08:00:00" "2022-05-01 13:07:59" 1 1 https://www.dpbolvw.net/click-TestCJP-55431 https://go.redirectingat.com/?id=1&xs=1&xcust=4mtc&url=https%3A%2F%2Fwww.areyougame.com%2F https://freshreach.co/click.php?m=13&cid=FMTC&uid=9107&sid=4mtc https://fmtc.co/m/13/ US "US CA UK AU" toys-games 645 "Heather Mannion" "affiliates@areyougame.com " 0 0 0 |
...
Here is an example of a PIPE Response from the getMerchants Deal Merchants endpoint.
| Code Block |
|---|
id|master_merchant_id|name|homepage|premium|network_id|program_id|dual_merchants|status|created|last_updated|selected_status|relationship_status|affiliate_url|skimlinks_url|freshreach_url|fmtc_url|primary_country|shiptocountries|categories|skimlinks_id|network_notes|rep_name|rep_email|rep_phone|apo_fpo_shipping|curbside_pickup|mobile_certified 13|13|AreYouGame.com|https://www.areyougame.com/|0|3|247913||active|"2007-01-01 08:00:00"|"2022-05-01 13:07:59"|1|1|https://www.dpbolvw.net/click-TestCJP-55431|https://go.redirectingat.com/?id=1&xs=1&xcust=4mtc&url=https%3A%2F%2Fwww.areyougame.com%2F|https://freshreach.co/click.php?m=13&cid=FMTC&uid=9107&sid=4mtc|https://fmtc.co/m/13/|US|"US| CA| UK| AU"|toys-games|645||"Heather Mannion"|"affiliates@areyougame.com "||0|0|0 |
...