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

# Networks and network groups in the Affiliate.com API

> Networks are affiliate platforms like Rakuten or Awin. Each network hosts merchants and their products. Use network IDs to scope product searches.

A network is an affiliate platform that connects publishers (you) with merchants and their products. Examples include Impact US, Rakuten US, Awin UK, and FlexOffers. Each network operates independently — it has its own set of merchants, products, and affiliate link formats.

## Network groups

Related regional networks are organized into **network groups**. For example, Impact Sweden, Impact UK, and Impact US all belong to the "Impact" group. Network groups let you find and filter across all regional variants of a network without needing to know every individual network ID.

You can list all network groups from:

```
GET /v1/network-groups
```

And list all networks from:

```
GET /v1/networks
```

## Network object

```json theme={null}
{
  "id": 211,
  "slug": "rnet_wet1d3wp",
  "name": "ClixGalore Australia",
  "region": "AU",
  "url": "https://www.clixgalore.com",
  "logo_url": "https://img.affiliate.com/logos/groups/10011/64x64.png",
  "icon_url": "https://img.affiliate.com/logos/groups/10011/64x64.png",
  "canonical_id": "net_01kkgbymywvbf5qjdcdwchxdhk",
  "merchant_count": 398,
  "merchant_count_active": 13,
  "product_count": 61972,
  "group": {
    "id": 10011,
    "name": "ClixGalore"
  },
  "country": {
    "id": "AU",
    "iso3": "AUS",
    "name": "Australia"
  },
  "links": {
    "self": "https://api.affiliate.com/v1/networks/rnet_01kkgbyq5vgd49n19twet1d3wp",
    "canonical": "https://api.affiliate.com/v1/networks/net_01kkgbymywvbf5qjdcdwchxdhk"
  }
}
```

## Key fields

| Field                   | Type    | Description                                                               |
| ----------------------- | ------- | ------------------------------------------------------------------------- |
| `id`                    | integer | Unique identifier for the network. Use this in product search requests    |
| `slug`                  | string  | Unique network slug in `rnet_` format.                                    |
| `name`                  | string  | Display name of the network (e.g., "Awin UK", "Impact US")                |
| `region`                | string  | ISO 3166-1 alpha-2 region code (e.g., `"US"`, `"GB"`).                    |
| `url`                   | string  | Network homepage URL.                                                     |
| `logo_url`              | string  | URL to the network's logo image                                           |
| `icon_url`              | string  | URL to the network's icon.                                                |
| `canonical_id`          | string  | Canonical network ID in `net_ULID` format — groups all regional variants. |
| `merchant_count`        | integer | Total number of merchants registered in this network                      |
| `merchant_count_active` | integer | Number of merchants with active product feeds                             |
| `product_count`         | integer | Total number of products available through this network                   |
| `group.id`              | integer | ID of the network group this network belongs to                           |
| `group.name`            | string  | Name of the network group (e.g., "Impact", "Awin", "ClixGalore")          |
| `country.id`            | string  | ISO 3166-1 alpha-2 country code (e.g., `"US"`, `"GB"`)                    |
| `country.iso3`          | string  | ISO 3166-1 alpha-3 country code (e.g., `"USA"`, `"GBR"`)                  |
| `country.name`          | string  | Full country name (e.g., "United States", "United Kingdom")               |
| `links.self`            | string  | API link to this regional network record.                                 |
| `links.canonical`       | string  | API link to the canonical (cross-region) network.                         |

## How networks relate to merchants

Each merchant belongs to exactly one network. When you look up a merchant, its `network` object tells you which network it operates through. When you search for products, each product includes a `network` object so you know which network is providing the listing.

## Using network IDs in product search

To scope a product search to one or more networks, include the network ID in your search criteria:

```json theme={null}
{
  "search": [
    {
      "field": "any",
      "value": "running shoes",
      "operator": "LIKE"
    },
    {
      "field": "network.id",
      "value": "314",
      "operator": "="
    }
  ],
  "networks": {
    "314": {
      "affiliate_id": "your_affiliate_id",
      "sub_id": "your_sub_id"
    }
  }
}
```

To search across multiple networks at once, separate the IDs with `||`:

```json theme={null}
{
  "field": "network.id",
  "value": "314||329||600",
  "operator": "="
}
```

You can also filter by network name if you don't have the ID:

```json theme={null}
{
  "field": "network.name",
  "value": "impact",
  "operator": "LIKE"
}
```

To find the correct network ID for a given network, use the networks endpoint with a name search:

```
GET /v1/networks?search=impact
```