Page tree


Before using PubMatic APIs, first generate the API Token. For more information, refer to  Getting Started with PubMatic APIs

Overview

This API allows you to retrieve the list of all the advertiser categories present in the PubMatic system.

Request

         

URIhttp://{domainName}/common/advertiserCategory?pageSize=20&pageNumber=1
HTTP MethodGET

Request Headers

               

Header NameTypeRequiredDescription
PubToken yes

 

Request Query Parameters

                     

Parameter NameTypeRequiredDescription
pageNumberIntegeroptionaldefault value is 1
pageSizeIntegeroptionaldefault value is 100

Response
Response Headers

           

Response Header NameType
Content-typeapplication-json

 

Response Body

                       

Response Body ParameterTypeDescription
metaDataObjectPagination details
idIntegerUnique ID of the advertiser category
nameStringName of the advertiser category

Sample JSON Response:


{

    "metaData": {

        "startIndex": 1,

        "request": {

            "pageSize": 3,

            "pageNumber": 1,

            "useAllDimensions": false

        },

        "totalRecords": 42,

        "endIndex": 3

    },

    "items": [

        {

            "id": 1,

            "name": "Alcohol"

        },

        {

            "id": 2,

            "name": "Auto"

        },

        {

            "id": 3,

            "name": "Consumer Products & Goods"

        }

    ]

}