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

# GET /v1/networks — list all affiliate networks

> Retrieve a paginated list of affiliate networks with merchant counts, product totals, logos, country data, and parent network group associations.

Use this endpoint to retrieve the full list of affiliate networks available on Affiliate.com. Unlike network groups, each network represents a specific regional instance of a platform — for example, ClixGalore Australia or Webgains UK. You can filter by name using the `search` parameter and control pagination with `page` and `per_page`.

## Endpoint

```
GET /v1/networks
```

## Request

### Headers

<ParamField header="Authorization" type="string" required>
  Your bearer token in the format `Bearer <token>`.
</ParamField>

### Query parameters

<ParamField query="fields" type="string">
  Comma-separated list of fields to return for each network (e.g. `fields=name,logo_url`). When omitted, all fields are returned.
</ParamField>

<ParamField query="page" type="integer">
  The page number to retrieve. Defaults to `1`.
</ParamField>

<ParamField query="per_page" type="integer">
  The number of networks to return per page. Defaults to `100`.
</ParamField>

<ParamField query="search" type="string">
  Filter networks by name. For example, `?search=impact` returns all networks whose name contains "impact".
</ParamField>

### Example request

```bash theme={null}
curl --location --request GET 'https://api.affiliate.com/v1/networks?page=1&fields=name,logo_url&per_page=10&search=impact' \
--header 'Authorization: Bearer {{token}}'
```

## Responses

### 200 — OK

Returns a paginated JSON object. The `meta` key contains pagination details and the `data` array contains the network records.

<ResponseField name="meta" type="object">
  Pagination metadata for the response.

  <Expandable title="meta">
    <ResponseField name="total" type="integer">
      The total number of networks matching your query.
    </ResponseField>

    <ResponseField name="from" type="integer">
      The index of the first record on the current page.
    </ResponseField>

    <ResponseField name="to" type="integer">
      The index of the last record on the current page.
    </ResponseField>

    <ResponseField name="current_page" type="integer">
      The current page number.
    </ResponseField>

    <ResponseField name="last_page" type="integer">
      The total number of pages available.
    </ResponseField>

    <ResponseField name="per_page" type="integer">
      The number of records per page.
    </ResponseField>

    <ResponseField name="fields" type="array">
      The fields included in each network object within `data`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="data" type="array">
  An array of network objects.

  <Expandable title="data[]">
    <ResponseField name="id" type="integer">
      The unique identifier for the network.
    </ResponseField>

    <ResponseField name="name" type="string">
      The display name of the network (e.g. `"ClixGalore Australia"`).
    </ResponseField>

    <ResponseField name="logo_url" type="string">
      URL pointing to the network's 128×128 logo image.
    </ResponseField>

    <ResponseField name="merchant_count" type="integer">
      The total number of merchants on this network.
    </ResponseField>

    <ResponseField name="merchant_count_active" type="integer">
      The number of currently active merchants on this network.
    </ResponseField>

    <ResponseField name="product_count" type="integer">
      The total number of products indexed for this network.
    </ResponseField>

    <ResponseField name="group" type="object">
      The parent network group this network belongs to.

      <Expandable title="group">
        <ResponseField name="id" type="integer">
          The unique identifier of the parent network group.
        </ResponseField>

        <ResponseField name="name" type="string">
          The name of the parent network group.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="country" type="object">
      The country associated with this network.

      <Expandable title="country">
        <ResponseField name="id" type="string">
          ISO 3166-1 alpha-2 country code (e.g. `"AU"`).
        </ResponseField>

        <ResponseField name="iso3" type="string">
          ISO 3166-1 alpha-3 country code (e.g. `"AUS"`).
        </ResponseField>

        <ResponseField name="name" type="string">
          The full country name (e.g. `"Australia"`).
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

#### Example response

```json theme={null}
{
    "meta": {
        "total": 0,
        "from": 1,
        "to": 0,
        "current_page": 1,
        "last_page": 0,
        "per_page": 100,
        "fields": [
            "id",
            "name",
            "logo_url",
            "merchant_count",
            "merchant_count_active",
            "product_count",
            "group",
            "country"
        ]
    },
    "data": [
        {
            "id": 211,
            "name": "ClixGalore Australia",
            "logo_url": "https://api.affiliate.com/img/logos/groups/10011/128x128.png",
            "merchant_count": 398,
            "merchant_count_active": 13,
            "product_count": 61972,
            "group": {
                "id": 10011,
                "name": "ClixGalore"
            },
            "country": {
                "id": "AU",
                "iso3": "AUS",
                "name": "Australia"
            }
        },
        {
            "id": 212,
            "name": "ClixGalore New Zealand",
            "logo_url": "https://api.affiliate.com/img/logos/groups/10011/128x128.png",
            "merchant_count": 39,
            "merchant_count_active": 2,
            "product_count": 652,
            "group": {
                "id": 10011,
                "name": "ClixGalore"
            },
            "country": {
                "id": "NZ",
                "iso3": "NZL",
                "name": "New Zealand"
            }
        },
        {
            "id": 213,
            "name": "ClixGalore UK",
            "logo_url": "https://api.affiliate.com/img/logos/groups/10011/128x128.png",
            "merchant_count": 139,
            "merchant_count_active": 3,
            "product_count": 742,
            "group": {
                "id": 10011,
                "name": "ClixGalore"
            },
            "country": {
                "id": "GB",
                "iso3": "GBR",
                "name": "United Kingdom"
            }
        },
        {
            "id": 221,
            "name": "Webgains UK Coupons/Deals",
            "logo_url": "https://api.affiliate.com/img/logos/groups/10036/128x128.png",
            "merchant_count": 1933,
            "merchant_count_active": 0,
            "product_count": 0,
            "group": {
                "id": 10036,
                "name": "Webgains"
            },
            "country": {
                "id": "GB",
                "iso3": "GBR",
                "name": "United Kingdom"
            }
        }
    ]
}
```

### 400 — Invalid input

One or more query parameters have invalid values. Check your `fields`, `page`, or `per_page` values.

### 401 — Unauthenticated

Your bearer token is missing, expired, or invalid.

### 429 — Rate Limit Exceeded

You have exceeded your team's request rate limit. Wait before retrying.
