Merchants: retailers and brands within affiliate networks

A merchant is an individual retailer or brand that sells products through an affiliate network. For example, Levi’s listed on FlexOffers US and Walmart Canada listed on Rakuten US are both merchants. A single real-world company can appear as multiple merchants if it participates in more than one network or region. Additionally, some merchants organize their catalogs in multiple instances on the same network (e.g. Walmart). The Affiliate.com platform normalizes merchant data across networks, giving you a consistent set of fields regardless of which network the merchant belongs to.

Merchants endpoint

List all merchants:

GET /v1/merchants?extended=1

Look up a merchant by ID:

GET /v1/merchants/{id}?extended=1

Pass extended=1 on every request. Whether the extended fields come back by default depends on your account, so don’t assume they will. extended=1 is what returns providers, canonical, categories, countries, currencies, supports, supports_deeplinking, cookie_duration, home_url, object_id, and slug — and it’s harmless if your account already returns them. The merchant object below is the extended response.

Merchant object

{
  "id": 57131,
  "object_id": "nmer_01khfmrf8ch48c9r6at188r4rf",
  "slug": "nmer_t188r4rf",
  "origin_id": "1433375654",
  "name": "Levi's",
  "description": "Levi's is synonymous with denim jeans.",
  "domains": ["https://www.levi.com/us/en_us"],
  "home_url": "https://www.levi.com",
  "icon_url": "https://img.affiliate.com/logos/merchants/57131/icon.png",
  "logo_url": "https://img.affiliate.com/logos/canonical_merchants/01kkkkr948r2tq0pev510ch57j/logo.png",
  "product_count": 28391,
  "cookie_duration": "P7D",
  "supports_deeplinking": true,
  "categories": [
    {
      "id": "cat_01kkgcmxh8frckhytad1jz15xt",
      "breadcrumb": "Apparel & Accessories",
      "name": "Apparel & Accessories",
      "shopify_id": "aa",
      "google_id": "166"
    }
  ],
  "countries": ["US"],
  "currencies": ["USD"],
  "supports": { "products": true, "services": false, "promotions": false },
  "providers": [
    {
      "provider": "network",
      "status": "approved",
      "status_changed_at": "2025-01-15T10:00:00+00:00",
      "credential_id": "01kkgc7xxw8gg7y7f6wrnpgepv",
      "url": "https://track.flexoffers.com/click?mid=57131&id=12345",
      "template": "https://track.flexoffers.com/click?mid=57131&id={AFF_ID}",
      "outclick": "https://outclick.co/a/2.NetworkOpaqueToken?affiliate_id={AFF_ID}&sub_id={SUB_ID}",
      "supports_deeplinking": true,
      "deeplink": null,
      "approval": {
        "commission_data": {
          "action_name": "Default Sale",
          "action_type": "advanced sale",
          "commission_default": "8.00%"
        },
        "epc_data": {
          "currency": "USD",
          "seven_day": "5.10",
          "three_month": "13.70"
        },
        "cookie_duration": "P1M2D",
        "start_date": "2025-06-24",
        "end_date": null,
        "terms_and_conditions": "<h2>Terms and Conditions</h2><p>Program terms as reported by the network — HTML, and often long.</p>"
      }
    },
    {
      "provider": "shopnomix",
      "status": "approved",
      "status_changed_at": "2026-03-18T14:02:55+00:00",
      "credential_id": "01j8z3example000credential",
      "url": "https://r.v2i8b.com/api/v1/bid/redirect?url=https%3A%2F%2Fwww.levi.com&campaign_id=01J8Z3K9QW7RT2VN5XB6MC4FDH&source={SUB_ID}",
      "template": "https://r.v2i8b.com/api/v1/bid/redirect?url=https%3A%2F%2Fwww.levi.com&campaign_id={AFF_ID}&source={SUB_ID}",
      "outclick": "https://outclick.co/a/2.ShopnomixOpaqueToken?affiliate_id={AFF_ID}&sub_id={SUB_ID}",
      "supports_deeplinking": true,
      "deeplink": {
        "domain": "levi.com",
        "template": "https://r.v2i8b.com/api/v1/bid/redirect?url={target_url}&campaign_id=01J8Z3K9QW7RT2VN5XB6MC4FDH&source={SUB_ID}"
      },
      "approval": null
    }
  ],
  "network": {
    "id": 600,
    "slug": "rnet_wet1d3wp",
    "name": "FlexOffers US",
    "region": "US",
    "url": "https://www.flexoffers.com",
    "logo_url": "https://img.affiliate.com/logos/groups/10018/64x64.png",
    "icon_url": "https://img.affiliate.com/logos/groups/10018/64x64.png",
    "canonical_id": "net_01kkgbymywvbf5qjdcdwchxdhk",
    "links": {
      "self": "https://api.affiliate.com/v1/networks/rnet_01kkgbyq5vgd49n19twet1d3wp",
      "canonical": "https://api.affiliate.com/v1/networks/net_01kkgbymywvbf5qjdcdwchxdhk"
    }
  },
  "canonical": {
    "id": "mer_01kkkkr948r2tq0pev510ch57j",
    "slug": "mer_510ch57j",
    "name": "Levi's",
    "site_url": "https://www.levi.com",
    "logo_url": "https://img.affiliate.com/logos/canonical_merchants/01kkkkr948r2tq0pev510ch57j/logo.png",
    "icon_url": null,
    "domains": { "levi.com": "mer_01kkkkr948r2tq0pev510ch57j" },
    "domain_canonical_id": null,
    "links": {
      "self": "https://api.affiliate.com/v1/merchants/mer_01kkkkr948r2tq0pev510ch57j",
      "domain_canonical": null
    }
  }
}

Key fields

Field	Type	Description
`id`	integer	Legacy numeric merchant ID
`object_id`	string	Unique identifier in `nmer_ULID` format. Use for new integrations.
`slug`	string	Short URL-friendly identifier.
`origin_id`	string	Merchant’s ID in the originating network.
`name`	string	Display name of the merchant
`description`	string\|null	Merchant description
`domains`	array	Canonical domain(s) for the merchant’s website
`home_url`	string\|null	Merchant homepage URL.
`icon_url`	string	Merchant icon URL
`logo_url`	string	Merchant logo URL (sourced from canonical when available)
`product_count`	integer	Products currently available from this merchant
`cookie_duration`	string\|null	Cookie window as ISO 8601 duration (e.g. `P7D` = 7 days).
`supports_deeplinking`	boolean\|null	Whether deep link tracking is supported.
`categories`	array	Taxonomy categories. Each has `id`, `breadcrumb`, `name`, `shopify_id`, `google_id`.
`countries`	array	ISO 3166-1 alpha-2 codes where the merchant operates.
`currencies`	array	ISO 4217 currency codes accepted.
`supports`	object	What the merchant monetizes: `products`, `services`, `promotions` (booleans).
`providers`	array	Ways to earn commission on this merchant — one entry per network/subnetwork, each with `status`, `url`, `template`, `outclick`, `deeplink`, `approval`. See Provider status values and the merchant reference for how `outclick` works.
`network`	object	The affiliate network this merchant belongs to
`canonical`	object\|null	The deduplicated canonical merchant record.

Provider status values

Each provider’s status reflects your account’s standing on that channel.

Value	Description
`approved`	Active approved relationship
`pending`	Application submitted, not yet approved
`rejected`	Application was declined, disapproved, or denied
`terminated`	Previously approved relationship has ended
`available`	Programme is open — you have not yet applied
`unavailable`	Programme is closed to new applicants
`unknown`	Status could not be determined
`null`	No relationship, or request made without an API key

How merchants relate to networks

Every merchant belongs to exactly one network. The network object embedded in each merchant tells you which network it operates through. If the same retailer participates in multiple networks or regions, it appears as a separate merchant record for each one.

Filtering merchants

The merchants endpoint supports several query parameters to narrow results:

Parameter	Description
`search`	Search by merchant name (e.g., `?search=best+buy`) or domain (e.g., `bestbuy.com`)
`network_ids`	Comma-separated list of network IDs to filter by
`has_icon`	`1` to return only merchants with an icon URL
`has_logo`	`1` to return only merchants with a logo URL
`has_domains`	`1` to return only merchants with at least one domain
`has_description`	`1` to return only merchants with a description
`product_count_min`	Minimum number of products the merchant must have
`product_count_max`	Maximum number of products the merchant can have
`type[]`	Filter by record type: `products`, `service`, `promotions` (alias `coupons`), plus `all`, `both`, `none`.
`has_commissionable_url`	`1` to return only merchants that have a commissionable link template.

Using merchant IDs in product search

To search for products from a specific merchant, use the merchant.id field in your search criteria:

{
  "search": [
    {
      "field": "any",
      "value": "denim jeans",
      "operator": "LIKE"
    },
    {
      "field": "merchant.id",
      "value": "57131",
      "operator": "="
    }
  ],
  "networks": {
    "600": {
      "affiliate_id": "your_affiliate_id",
      "sub_id": "your_sub_id"
    }
  }
}

To include products from multiple merchants, separate their IDs with ||:

{
  "field": "merchant.id",
  "value": "57131||37590",
  "operator": "="
}

To exclude a specific merchant from results:

{
  "field": "merchant.id",
  "value": "37590",
  "operator": "!="
}

Get Started

Core Concepts

Reporting

Merchants: retailers and brands within affiliate networks

Merchants endpoint

Merchant object

Key fields

Provider status values

How merchants relate to networks

Filtering merchants

Using merchant IDs in product search

​Merchants endpoint

​Merchant object

​Key fields

​Provider status values

​How merchants relate to networks

​Filtering merchants

​Using merchant IDs in product search

Merchants endpoint

Merchant object

Key fields

Provider status values

How merchants relate to networks

Filtering merchants

Using merchant IDs in product search