> ## Documentation Index > Fetch the complete documentation index at: https://guides.affiliate.com/llms.txt > Use this file to discover all available pages before exploring further. # Merchants: retailers and brands within affiliate networks > Merchants are individual retailers within a network, like Levi's or Walmart. Use merchant IDs to scope product searches to specific sellers. 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 ```json theme={null} { "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": "

Terms and Conditions

Program terms as reported by the network — HTML, and often long.

" } }, { "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](#provider-status-values) and the [merchant reference](/api-reference/merchants/list-merchants#outclick-links) 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: ```json theme={null} { "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 `||`: ```json theme={null} { "field": "merchant.id", "value": "57131||37590", "operator": "=" } ``` To exclude a specific merchant from results: ```json theme={null} { "field": "merchant.id", "value": "37590", "operator": "!=" } ```