The FMTC products API allows developers and affiliates to access structured product data from over 142 million products across multiple merchants. This guide explains how to use the API, key parameters, and how to integrate it into your product feed workflow.

What is the Products API?

The endpoint Products returns structured product data for over 142,000,000 products, providing you with normalized affiliate product links for our Product Feed. A call to Products is available in two machine-readable formats: JSON and XML. These format options can be configured by providing the “format” parameter to any request.

A basic Products call looks like this:

The key parameter is a string we provide in your dashboard that authenticates your request. The key is required for any requests to the getProducts endpoint; if it is missing, you will get an error message. For the rest of this post, we will use <API_KEY> to represent your key.

While the mode parameter is not required, it is an important parameter to understand what you are getting back from your API call. The following values are the potential values for mode:

• Products: Returns one (single) CMID (Cross Merchant Identifier) product from all (selected) merchants. The results from this endpoint may return a single record from a single merchant. If you have multiple merchants selected in your feed (typical use case), you may receive multiple records for the single product.
• brands:
• products-merchants: Returns multiple products from one requested merchant based on request parameters. The merchant parameter is required for this mode to return the products properly.

Request Parameters

A call to Products can be filtered using up to six parameters. Some of these parameters override each other. Here’s a breakdown:

network: Gives a comma-separated list of networks. Please use the slugs from the Networks endpoint. The request parameter below will return deals for all the merchants you’ve selected from Awin and CJ.

&network=aw,cj

merchant_ids: Gives a comma-separated list of FMTC merchant program IDs. This request parameter will return products for merchants #12345 and #9876. Merchant IDs can be found on the Product Programs page on your dashboard (“FMTC ID” column) or via a Products Merchants API call.

&merchant_ids=12345,9876

category_ids: Returns products for a particular category. This can only be done with top-level categories, not the sub-categories within FMTC. For example: clothing-apparel, education, health-beauty. To call, give a comma-separated list of category IDs. A Category list be found via a here.

brand_ids: Returns only products from a particular brand/manufacturer. Example: Nike, Hasbro, or Abercrombie & Fitch. To call, give a comma-separated list of brands. Use the Brand API endpoint for available brands. This example returns all products from all merchants that have the brand of Nike, Adidas, and Skechers.

&brand_ids=nike,adidas,skechers

latest_days and latest-time: The latest_days parameter is a look-back window for product verification: e.g. latest_days=7 returns products verified any time within the past week.

only_on_sale: Are you only interested in products that are on sale? Add the on-sale parameter, a value of either 0 or 1. By default, this will be 0, ensuring that all products will be returned.

&only_on_sale=1

The getProducts endpoint is paginated. FMTC provides cursor pagination, and through the “cursor” parameter, it will provide both the nextCursor and backCursor values to traverse through the page results you receive through your current API call.

Downloading the getProducts feed will result in the fields listed in our API documentation. We encourage our subscribers to monitor the LastUpdate and ProcessedTime fields to ensure your products are up to date and working for your users.

Link Types

There are five types of links provided by getProducts. Depending on your access, you might not see all these links:

• AffiliateURL: This is an affiliate link containing your own affiliate ID that goes to the merchant’s product landing page and sets the appropriate network cookie. To generate these links, you need to input your affiliate ID in our dashboard under Relationships > Manage Network IDs.
• FreshreachURL: A link using FMTC’s FreshReach® program. It will appear if both the merchant and your account are FreshReach® enabled. If you would like FreshReach® enabled, please reach out to your Account Manager.
• SubaffiliateURL: Link that lands on the page associated with the product and is monetized by a sub-affiliate network.
• DirectURL: This is the direct, unmonetized non-affiliate link that lands on the page associated with the product. It may be a homepage link or a deep link. Only a few networks support a ‘direct link’ in the Product Feed.

Ready to build with structured product data at scale?

FMTC’s getProducts endpoint gives you access to millions of normalized products—so you can power richer shopping and discovery experiences from a single API.
👉 Sign up for a publisher subscription and start integrating today: https://www.fmtc.co/get-started/

---

For more information, please visit our full API documentation.

As always, our team is ready to help you! If you have any questions or concerns, feel free to contact your account manager or email us at [email protected]. Curious about other FMTC technologies? Find more information on FMTC’s tools in Tech Corner:

• FMTC Tech Corner: getDeals Deep Dive
• FMTC Tech Corner: getMerchants Deep Dive
• FMTC Tech Corner: Get Deals and Get Merchants
• FMTC Tech Corner: Deal Types and the getTypes API