Page tree


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

Overview

The Common APIs contains the master data APIs that are required to work with all other PubMatic-specific APIs. Typically, these APIs are "GET" calls which return the PubMatic master data which is fixed and pre-defined or managed by PubMatic. Partners can pull this data once and update it at a defined regular interval, say, once a day and keep it in their system which will be used later in other API calls.


View Common APIs for:

For Publishers

Methods

                                                         

Method PathHTTP Method TypeDescriptionLink to Definition
/common/adCategoryGETRetrieve the list of all the ad categories present in the PubMatic system.Retrieving List of Ad Categories
/common/adCategory/{id}GETRetrieve the details of a specific ad category from the PubMatic system.Retrieving Details of an Ad Category
/common/adSizeGETRetrieve the list of all the ad sizes present in the PubMatic system.Retrieving List of Ad Sizes
/common/adSize/{id}GETRetrieve the details of a specific ad size from the PubMatic system.Retrieving Details of an Ad Size
/common/geoGETRetrieve the list of all the Geos present in the PubMatic system.Retrieving List of Geos
/common/geo/{id}GETRetrieve the details of a specific Geo from the PubMatic system.Retrieving Details of a Geo
/common/microVerticalGETRetrieve the list of all the micro-verticals present in the PubMatic system.Retrieving List of Micro-Verticals
/common/microVertical/{id}GETRetrieve the details of a specific micro-vertical from the PubMatic system.Retrieving Details of a Micro-Vertical
/common/platform/GETRetrieve the list of all the platforms present in the PubMatic system.Retrieving List of Platforms
/common/platform/{id}GETRetrieve the details of a specific platform from the PubMatic system.Retrieving Details of a Platform
/common/browserGETRetrieve the list of all the browsers present in the PubMatic system.Retrieving List of Browsers
/common/browser/{id}GETRetrieve the details of a specific browser from the PubMatic system.Retrieving Details of a Browser
/common/browserlanguageGETRetrieve the list of browser languages present in the PubMatic system.Retrieving List of Browser Languages
/common/browserlanguage{id}GETRetrieve the details of a browser language for a specified Id.Retrieving Details of a Browser Language
/common/connectionTypeGETRetrieve the list of all the connection types present in the PubMatic system.Retrieving List of Connection Types
/common/pmconnectiontypeGETRetrieve the list of connection types supported in the PubMatic system.Retrieving List of Connection Types (New)
/common/connectionType/{id}GETRetrieve the details of a specific connection type from the PubMatic system.Retrieving Details of a Connection Type
/common/pmconnectiontype/{id}GETRetrieve the details of a connection type for the specified IdRetrieving Details of a Connection Type (New)
/common/mobileOSGETRetrieve the list of all the mobile Operating Systems present in the PubMatic system.Retrieving List of Mobile OS-
/common/mobileOS/{id}GETRetrieve the details of a specific mobile Operating System from the PubMatic system.Retrieving Details of a Mobile OS
/common/mobileDeviceTypeGETRetrieve the list of all the mobile device types present in the PubMatic system.Retrieving List of Mobile Device Types
/common/mobileDeviceType/{id}GETRetrieve the details of a specific mobile device type from the PubMatic system.Retrieving Details of a Mobile Device Type
/common/devicecapabilityGETRetrieve all device capabilities supported by the PubMatic system for targetingRetrieving a List of Device Capabilities
/common/devicecapability/{id}GETRetrieve the device capability details of a specific id in the PubMatic systemRetrieving Device Capability Details 
/common/mobileDeviceGETRetrieve the list of all device manufacturers/makesRetrieving List of Device Manufacturers/Makes
/common/mobileDeviceGETRetrieve the list of device models for a selected makeRetrieving List of Device Models for a Selected Make

/common/mobileDevice/{id}

GETRetrieve the details of manufacturer/make or model supported in the PubMatic system.Retrieving Details of Device Manufacturer/Make or Model
/common/mobileCarrierGETRetrieve the list of all the mobile carriers present in the PubMatic system.Retrieving List of Mobile Carriers
/common/mobileCarrier/{id}GETRetrieve the details of a specific mobile carrier from the PubMatic system.Retrieving Details of a Mobile Carrier
/common/phoneTypeGETRetrieve the list of all the phone types present in the PubMatic system.Retrieving List of Phone Types
/common/phoneType/{id}GETRetrieve the details of a specific phone type from the PubMatic system.Retrieving Details of a Phone Type


For Buyers

Methods

                                                                                                                                                                                                                                                                           

Method PathHTTP Method TypeDescriptionLink to Definition
/common/adCategory/{id}GETRetrieve the details of a specific ad category from the PubMatic system.Retrieving Details of an Ad Category
/common/adNetwork/{id}GETRetrieve the details of a specific ad network from the PubMatic system.Retrieving Details of an Ad Network
/common/foldPlacementGETRetrieve the list of all the fold placements present in the PubMatic system.Retrieving List of Fold Placements
/common/foldPlacement/{id}GETRetrieve the details of a specific fold placement from the PubMatic system.Retrieving Details of a Fold Placement
/common/vertical?pageSize=20&pageNumber=1GETRetrieve the list of all the verticals present in the PubMatic systemRetrieving List of Verticals
/common/vertical/{id}GETRetrieve the details of a specific vertical from the PubMatic system.Retrieving Details of a Vertical
/common/videoTypeGETRetrieve the list of all the video ad types present in the PubMatic system.Retrieving List of Video Ad Types
/common/videoType/{id}GETRetrieve the details of a specific video ad type from the PubMatic system.Retrieving Details of a Video Ad Type
/common/videoPositionGETRetrieve the list of all the video ad positions present in the PubMatic system.Retrieving List of Video Ad Positions
/common/videoPosition/{id}GETRetrieve the details of a specific video ad position from the PubMatic system.Retrieving Details of a Video Ad Position
/common/videoPlaybackGETRetrieve the list of all the video ad playback methods present in the PubMatic system.Retrieving List of Video Ad Playback Methods
/common/videoPlayback/{id}GETRetrieve the details of a specific video ad playback method from the PubMatic system.Retrieving Details of a Video Ad Playback Method
/common/richMediaTechnologyGETRetrieve the list of all the rich media vendors present in the PubMatic system.Retrieving List of Rich Media Vendors
/common/richMediaTechnology/{id}GETRetrieve the details of a specific rich media vendor from the PubMatic system.Retrieving Details of a Rich Media Vendor
/common/pixel?pageSize=20&pageNumber=1GETRetrieve the list of all the pixels present in the PubMatic system.Retrieving a list of all pixels present in PubMatic
/common/pixel/{id}GETRetrieve the details of a pixel by using the pixel ID present in the PubMatic system.Retrieving Details of a Pixel by ID


                                       

Method Path

HTTP Method
Type

DescriptionLink to Definition
/common/advertiserCategoryGETRetrieving the details of all the advertiser's categories present in the PubMatic system.Retrieving List of Advertiser Categories
/common/advertiserGETRetrieving the details of all the advertisers present in the PubMatic system.Retrieving List of Advertisers
/common/advertiserDomainGETRetrieving the details of all the advertiser's domains present in the PubMatic system.Retrieving List of Advertiser Domains
/common/advertisingEntityGETRetrieving the details of all the PMP enabled DSPs.Retrieving List of PMP-enabled DSPs
/common/buyerGETRetrieving the details of all the PMP enabled buyers.Retrieving List of PMP-enabled Buyers