---
title: /v2/advertisers/{advertiserId}/exclusive-brands
slug: campaign-reporting-apis/v2advertisersadvertiseridexclusive-brands
docTags: 
createdAt: 2026-03-25T10:57:30.256Z
---

{
  "id": "jsBPGyw9GEyY_q59yEoHC",
  "type": "api-oas-v2",
  "data": {
    "method": "GET",
    "url": "https://<pcm-domain>/v2/advertisers/{advertiserId}/exclusive-brands",
    "servers": [
      {
        "url": "https://<pcm-domain>/v2/advertisers/{advertiserId}/exclusive-brands",
        "description": "Generated server url"
      }
    ],
    "name": "",
    "description": "<p>Retrieves the brands of the advertiser which exclusively belong to products\nof the publishers specified by id. In other words, none of the returned brands has\nproducts belonging to all the other publishers associated to the advertiser.\nThe <em>publisherIds</em> passed in the query string must be associated to the advertiser,\notherwise <em>UNPROCESSIBLE ENTITY</em> response code is returned.\nThe result can be used in order to identify the brands which need to be removed from the\nadvertiser whenever one or multiple publishers are disassociated from the advertiser.</p>",
    "contentType": "application/json",
    "request": {
      "pathParameters": [
        {
          "kind": "required",
          "name": "advertiserId",
          "type": "integer<int32>",
          "description": "",
          "format": "int32"
        }
      ],
      "headerParameters": [],
      "queryParameters": [
        {
          "kind": "required",
          "name": "publisherIds",
          "type": "array",
          "description": "",
          "schema": [],
          "itemType": "integer",
          "customType": "integer[]"
        }
      ],
      "bodyDataParameters": [],
      "formDataParameters": [],
      "oAuthParameters": []
    },
    "responses": [
      {
        "statusCode": "200",
        "description": "OK",
        "jsonExample": "",
        "isExpanded": true,
        "schema": [
          {
            "kind": "optional",
            "type": "array",
            "description": "",
            "schema": [],
            "itemType": "string",
            "customType": "string[]",
            "isExpanded": true
          }
        ]
      },
      {
        "statusCode": "401",
        "description": "Unauthorized",
        "jsonExample": "",
        "isExpanded": true
      },
      {
        "statusCode": "403",
        "description": "Forbidden",
        "jsonExample": "",
        "isExpanded": true
      },
      {
        "statusCode": "404",
        "description": "Not Found",
        "jsonExample": "",
        "isExpanded": true,
        "schema": [
          {
            "kind": "optional",
            "type": "object",
            "description": "",
            "customType": "ExceptionResponse",
            "schema": [
              {
                "name": "messages",
                "kind": "optional",
                "type": "array",
                "description": "",
                "example": "",
                "itemType": "string",
                "customType": "string[]",
                "itemExample": "",
                "itemDefault": ""
              }
            ],
            "modelRef": "#/components/schemas/ExceptionResponse",
            "isExpanded": true
          }
        ]
      },
      {
        "statusCode": "422",
        "description": "Unprocessable Entity",
        "jsonExample": "",
        "isExpanded": true,
        "schema": [
          {
            "kind": "optional",
            "type": "object",
            "description": "",
            "customType": "ExceptionResponse",
            "schema": [
              {
                "name": "messages",
                "kind": "optional",
                "type": "array",
                "description": "",
                "example": "",
                "itemType": "string",
                "customType": "string[]",
                "itemExample": "",
                "itemDefault": ""
              }
            ],
            "modelRef": "#/components/schemas/ExceptionResponse",
            "isExpanded": true
          }
        ]
      }
    ],
    "hasXCodeSamples": false,
    "examples": {
      "languages": [
        {
          "id": "I5rgAcCHikzoeMVzpAVvx",
          "language": "curl",
          "label": "cURL",
          "code": "curl --request GET \\\n     --url 'https://<pcm-domain>/v2/advertisers/{advertiserId}/exclusive-brands?publisherIds=array' \\\n     --header 'accept: application/json'"
        },
        {
          "id": "qq0mrCC1wtL04BfY3GWNL",
          "language": "javascript",
          "label": "javascript",
          "code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\n\nvar requestOptions = {\n   method: 'GET',\n   headers: myHeaders,\n   redirect: 'follow'\n};\n\nfetch(\"https://<pcm-domain>/v2/advertisers/{advertiserId}/exclusive-brands?publisherIds=array\", requestOptions)\n   .then(response => response.text())\n   .then(result => console.log(result))\n   .catch(error => console.log('error', error));"
        },
        {
          "id": "lsZNrZpRgz_8ZcvGOEGxm",
          "language": "ruby",
          "label": "Ruby",
          "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://<pcm-domain>/v2/advertisers/{advertiserId}/exclusive-brands?publisherIds=array\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Get.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\n\nresponse = https.request(request)\nputs response.read_body\n"
        },
        {
          "id": "EytT4MAYM2ikTt9FMCYSg",
          "language": "python",
          "label": "Python",
          "code": "import requests\nimport json\n\nurl = \"https://<pcm-domain>/v2/advertisers/{advertiserId}/exclusive-brands?publisherIds=array\"\n\npayload = {}\nheaders = {\n   'accept': 'application/json',\n   'content-type': 'application/json'\n}\n\nresponse = requests.request(\"GET\", url, headers=headers, data=payload)\n\nprint(response.text)\n"
        }
      ],
      "selectedLanguageId": "I5rgAcCHikzoeMVzpAVvx"
    },
    "results": {
      "languages": [
        {
          "id": "4oNc2QqQySxmvCHXaiJL7",
          "language": "200",
          "code": "// OK\n[\n  \"\"\n]"
        },
        {
          "id": "l27wiu_6PF0yudUtYZjNs",
          "language": "401",
          "code": "// Unauthorized\n"
        },
        {
          "id": "_CN0EuNeC0us88gm7-LDJ",
          "language": "403",
          "code": "// Forbidden\n"
        },
        {
          "id": "5-zefh4b2t4IXrO022cZ0",
          "language": "404",
          "code": "// Not Found\n{\n  \"messages\": [\n    \"\"\n  ]\n}"
        },
        {
          "id": "6vsElcHuooS5jupn3z3cb",
          "language": "422",
          "code": "// Unprocessable Entity\n{\n  \"messages\": [\n    \"\"\n  ]\n}"
        }
      ],
      "selectedLanguageId": "4oNc2QqQySxmvCHXaiJL7"
    }
  },
  "children": [
    {
      "text": ""
    }
  ]
}