> For the complete documentation index, see [llms.txt](https://docs.thebrief.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thebrief.ai/public-api/rest-api/ad-networks.md).

# Ad Networks

This endpoint makes an HTTP GET request to retrieve a list of ad networks from the specified API endpoint. The request does not include a request body as it is a GET request.

This endpoint is ***deprecated***, please use [List Ad Networks for Ad Serving](#list-a-d-networks-for-ad-serving) or [List Ad Networks for HTML](#list-a-d-networks-for-html) instead.

### Request

* Method: GET
* Endpoint: `https://api.thebrief.ai/v1/adnetworks`

```bash
curl --location 'ttps://api.thebrief.ai/v1/adnetworks' \
--header 'Authorization: Bearer eyJ...'
```

### Response

The response to the request is in JSON format with a status code of 200 (OK). The response body contains an array of ad network objects, each including an ID, name, type, adTag, HTML5, and status properties.

```json
{
    "response": [
        {
            "id": 0,
            "name": "",
            "type": "",
            "adTag": true,
            "html5": true,
            "status": true
        }
    ]
}

```

## List Ad Networks for Ad Serving

This endpoint requests an HTTP **GET** to retrieve a list of ad networks available for ad serving.

### Request

* Method: `GET`
* Endpoint: `https://api.thebrief.ai/v1/adnetworks/forAdserving`
* Query Parameters: This endpoint does not require any query parameters.

```bash
curl --location 'https://api.thebrief.ai/v1/adnetworks/forAdserving' \
--header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>'
```

### Response

Upon a successful execution, the response will have a status code of 200 and a JSON content type. The response body will contain the following structure:

JSON

{% code overflow="wrap" fullWidth="false" %}

```json
{
    "response": [
        {
            "id": 64,
            "name": "AdButler",
            "type": "ADBUTLER",
            "adTag": true,
            "html5": false,
            "status": true,
            "adNetworkTeams": []
        },
        {
            "id": 57,
            "name": "Adform",
            "type": "ADFORM",
            "adTag": true,
            "html5": true,
            "status": true,
            "adNetworkTeams": []
        }
    ]
}
```

{% endcode %}

Each object in the `response` array represents an ad network and contains the following fields:

| Field                        | Type    | Description                                                               |
| ---------------------------- | ------- | ------------------------------------------------------------------------- |
| `id`                         | Number  | Unique identifier of the ad network.                                      |
| `name`                       | String  | Name of the ad network.                                                   |
| `type`                       | String  | Type of the ad network.                                                   |
| `adTag`                      | Boolean | Indicates whether an ad tag is available. (Always true for this endpoint) |
| `html5`                      | Boolean | Indicates whether HTML5 ads are supported.                                |
| `status`                     | Boolean | Status of the ad network (e.g., active/inactive).                         |
| `adNetworkTeams`             | Object  | Team-related details for the ad network.                                  |
| `adNetworkTeams.teamId`      | Number  | ID of the team associated with the ad network.                            |
| `adNetworkTeams.adNetworkId` | Number  | ID of the ad network linked to the team.                                  |
| `adNetworkTeams.status`      | Boolean | Status of the ad network within the team.                                 |

## List Ad Networks for HTML

This endpoint requests an HTTP **GET** to retrieve a list of ad networks available for HTML

### Request

* Method: `GET`
* Endpoint: `https://api.thebrief.ai/v1/adnetworks/forHtml`
* Query Parameters: This endpoint does not require any query parameters.

```bash
curl --location 'https://api.thebrief.ai/v1/adnetworks/forHtml' \
--header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>'
```

### Response

Upon a successful execution, the response will have a status code of 200 and a JSON content type. The response body will contain the following structure:

JSON

```
{
    "response": [
        {
            "id": 1193,
            "name": "6Sense",
            "type": "6SENSE",
            "adTag": false,
            "html5": true,
            "status": true,
            "adNetworkTeams": []
        }
    ]
}
```

Each object in the `response` array represents an ad network and contains the following fields:

| Field                        | Type    | Description                                                                |
| ---------------------------- | ------- | -------------------------------------------------------------------------- |
| `id`                         | Number  | Unique identifier of the ad network.                                       |
| `name`                       | String  | Name of the ad network.                                                    |
| `type`                       | String  | Type of the ad network.                                                    |
| `adTag`                      | Boolean | Indicates whether an ad tag is available.                                  |
| `html5`                      | Boolean | Indicates whether HTML5 ads are supported. (Always true for this endpoint) |
| `status`                     | Boolean | Status of the ad network (e.g., active/inactive).                          |
| `adNetworkTeams`             | Object  | Team-related details for the ad network.                                   |
| `adNetworkTeams.teamId`      | Number  | ID of the team associated with the ad network.                             |
| `adNetworkTeams.adNetworkId` | Number  | ID of the ad network linked to the team.                                   |
| `adNetworkTeams.status`      | Boolean | Status of the ad network within the team.                                  |