Skip to main content

Master API

Overview​

The Master API contains static lists of data such as: geographical data, demographic data, Creative type/parameter data, and more.

Authentication​

Use the following header parameters for all requests:

Headers
Authentication
string required		Authentication bearer token
See Authentication Guide
X-IAA-OW-ID
integer required		Organization Worskpace ID Header

Get Geographical Data​

POST endpoints use the following request body schema (shown below) to retrieve paginated lists of geographical data based on provided filters:

Request Schema
pageNo
integer required		Page number for the required data, default: 1
noOfEntries
integer required		The maximum number of returned results per page, default: 300
sortBy
string optional		Sort the result set by specific field. For ascending use plus(+) sign and for descending use minus(-) sign, default: -id
searchField
string optional		Search the result by provided keyword in the searchField` search country records by name
campaignId
integer optional		Country records associated with the provided Campaign will be returned first, prioritized over other country records
ids
array of integers optional		Selected country ID List, countries with provided ids will be returned first compared to other records
segmentIds
array of integers optional		country list filter by country IDs

Get Zip Codes and State IDs​

POST /api/v3/master/segment/zip

Get a list of zip codes with state IDs.

Properties
id
integer		Zip code ID
name
string		Zip code name
parentId
integer		State ID
geojsonUrl
string		Json geographical data URL
Request Sample
{
  "pageNo": 1,
  "noOfEntries": 10,
  "sortBy": "+id",
  "searchField": "",
  "segmentIds": [],
  "ids": []
}
Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 30501001,
        "name": "01001",
        "parentId": 30200020,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/zipdata/US/30501001.geojson"
      },
      {
        "id": 30501002,
        "name": "01002",
        "parentId": 30200020,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/zipdata/US/30501002.geojson"
      },
      {
        "id": 30501003,
        "name": "01003",
        "parentId": 30200020,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/zipdata/US/30501003.geojson"
      },
      {
        "id": 30501005,
        "name": "01005",
        "parentId": 30200020,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/zipdata/US/30501005.geojson"
      },
      {
        "id": 30501007,
        "name": "01007",
        "parentId": 30200020,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/zipdata/US/30501007.geojson"
      },
      {
        "id": 30501008,
        "name": "01008",
        "parentId": 30200020,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/zipdata/US/30501008.geojson"
      },
      {
        "id": 30501009,
        "name": "01009",
        "parentId": 30200020,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/zipdata/US/30501009.geojson"
      },
      {
        "id": 30501010,
        "name": "01010",
        "parentId": 30200020,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/zipdata/US/30501010.geojson"
      },
      {
        "id": 30501011,
        "name": "01011",
        "parentId": 30200020,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/zipdata/US/30501011.geojson"
      },
      {
        "id": 30501012,
        "name": "01012",
        "parentId": 30200020,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/zipdata/US/30501012.geojson"
      }
    ],
    "totalRecords": 48777,
    "filteredRecords": 48777
  }
}

Get State segment​

POST /api/v3/master/segment/state
Properties
id
integer		State ID
name
string		State name
abbreviation
string		State abbreviation
parentId
integer		Country ID
geojsonUrl
string		Json geographical data URL
Request Sample
{
  "pageNo": 1,
  "noOfEntries": 10,
  "sortBy": "+id",
  "searchField": "",
  "segmentIds": [],
  "ids": []
}
Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 30200001,
        "name": "Alaska",
        "abbreviation": "AK",
        "parentId": 30100001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/statedata/AK.geojson"
      },
      {
        "id": 30200002,
        "name": "Alabama",
        "abbreviation": "AL",
        "parentId": 30100001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/statedata/AL.geojson"
      },
      {
        "id": 30200003,
        "name": "Arkansas",
        "abbreviation": "AR",
        "parentId": 30100001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/statedata/AR.geojson"
      },
      {
        "id": 30200004,
        "name": "Arizona",
        "abbreviation": "AZ",
        "parentId": 30100001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/statedata/AZ.geojson"
      },
      {
        "id": 30200005,
        "name": "California",
        "abbreviation": "CA",
        "parentId": 30100001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/statedata/CA.geojson"
      },
      {
        "id": 30200006,
        "name": "Colorado",
        "abbreviation": "CO",
        "parentId": 30100001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/statedata/CO.geojson"
      },
      {
        "id": 30200007,
        "name": "Connecticut",
        "abbreviation": "CT",
        "parentId": 30100001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/statedata/CT.geojson"
      },
      {
        "id": 30200008,
        "name": "District of Columbia",
        "abbreviation": "DC",
        "parentId": 30100001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/statedata/DC.geojson"
      },
      {
        "id": 30200009,
        "name": "Delaware",
        "abbreviation": "DE",
        "parentId": 30100001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/statedata/DE.geojson"
      },
      {
        "id": 30200010,
        "name": "Florida",
        "abbreviation": "FL",
        "parentId": 30100001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/statedata/FL.geojson"
      }
    ],
    "totalRecords": 4964,
    "filteredRecords": 4964
  }
}

Get Senate District segment​

POST /api/v3/master/segment/senate-district
Properties
id
integer		Senate District ID
name
string		Senate District name
abbreviation
string		Senate District abbreviation
parentId
integer		State ID
geojsonUrl
string		Json geographical data URL
Request Sample
{
  "pageNo": 1,
  "noOfEntries": 10,
  "sortBy": "+id",
  "searchField": "",
  "segmentIds": [],
  "ids": []
}
Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 30700001,
        "name": "Alaska-A",
        "abbreviation": "AK-A",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/sd/AK/30700001.geojson"
      },
      {
        "id": 30700002,
        "name": "Alaska-B",
        "abbreviation": "AK-B",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/sd/AK/30700002.geojson"
      },
      {
        "id": 30700003,
        "name": "Alaska-C",
        "abbreviation": "AK-C",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/sd/AK/30700003.geojson"
      },
      {
        "id": 30700004,
        "name": "Alaska-D",
        "abbreviation": "AK-D",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/sd/AK/30700004.geojson"
      },
      {
        "id": 30700005,
        "name": "Alaska-E",
        "abbreviation": "AK-E",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/sd/AK/30700005.geojson"
      },
      {
        "id": 30700006,
        "name": "Alaska-F",
        "abbreviation": "AK-F",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/sd/AK/30700006.geojson"
      },
      {
        "id": 30700007,
        "name": "Alaska-G",
        "abbreviation": "AK-G",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/sd/AK/30700007.geojson"
      },
      {
        "id": 30700008,
        "name": "Alaska-H",
        "abbreviation": "AK-H",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/sd/AK/30700008.geojson"
      },
      {
        "id": 30700009,
        "name": "Alaska-I",
        "abbreviation": "AK-I",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/sd/AK/30700009.geojson"
      },
      {
        "id": 30700010,
        "name": "Alaska-J",
        "abbreviation": "AK-J",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/sd/AK/30700010.geojson"
      }
    ],
    "totalRecords": 1950,
    "filteredRecords": 1950
  }
}

Get House District segment​

POST /api/v3/master/segment/house-district
Properties
id
integer		House District ID
name
string		House District name
abbreviation
string		House District abbreviation
parentId
integer		State ID
geojsonUrl
string		Json geographical data URL
Request Sample
{
  "pageNo": 1,
  "noOfEntries": 10,
  "sortBy": "+id",
  "searchField": "",
  "segmentIds": [],
  "ids": []
}
Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 30800073,
        "name": "Alaska-1",
        "abbreviation": "AK-01",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/hd/AK/30800073.geojson"
      },
      {
        "id": 30800074,
        "name": "Alaska-2",
        "abbreviation": "AK-02",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/hd/AK/30800074.geojson"
      },
      {
        "id": 30800075,
        "name": "Alaska-3",
        "abbreviation": "AK-03",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/hd/AK/30800075.geojson"
      },
      {
        "id": 30800076,
        "name": "Alaska-4",
        "abbreviation": "AK-04",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/hd/AK/30800076.geojson"
      },
      {
        "id": 30800077,
        "name": "Alaska-5",
        "abbreviation": "AK-05",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/hd/AK/30800077.geojson"
      },
      {
        "id": 30800078,
        "name": "Alaska-6",
        "abbreviation": "AK-06",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/hd/AK/30800078.geojson"
      },
      {
        "id": 30800079,
        "name": "Alaska-7",
        "abbreviation": "AK-07",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/hd/AK/30800079.geojson"
      },
      {
        "id": 30800080,
        "name": "Alaska-8",
        "abbreviation": "AK-08",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/hd/AK/30800080.geojson"
      },
      {
        "id": 30800081,
        "name": "Alaska-9",
        "abbreviation": "AK-09",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/hd/AK/30800081.geojson"
      },
      {
        "id": 30800082,
        "name": "Alaska-10",
        "abbreviation": "AK-10",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/hd/AK/30800082.geojson"
      }
    ],
    "totalRecords": 4833,
    "filteredRecords": 4833
  }
}

Get Gender segment​

POST /api/v3/master/segment/gender
Properties
id
integer		Gender ID
name
string		Gender name
Request Sample
{
  "pageNo": 1,
  "noOfEntries": 3,
  "sortBy": "+id",
  "searchField": "",
  "segmentIds": [],
  "ids": []
}
Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 10200001,
        "name": "Male"
      },
      {
        "id": 10200002,
        "name": "Female"
      },
      {
        "id": 10299999,
        "name": "Unknown"
      }
    ],
    "totalRecords": 3,
    "filteredRecords": 3
  }
}

Get Age Segment​

GET /api/v2/master/segment/age

Get list of age range IDs.

Response 200
{
  "statusCode": 200,
  "responseObject": {
    "data": [
      {
        "id": 10100001,
        "name": "13-17"
      },
      {
        "id": 10100008,
        "name": "18-20"
      },
      {
        "id": 10100009,
        "name": "21-24"
      },
      {
        "id": 10100003,
        "name": "25-34"
      },
      {
        "id": 10100004,
        "name": "35-44"
      },
      {
        "id": 10100005,
        "name": "45-54"
      },
      {
        "id": 10100006,
        "name": "55-64"
      },
      {
        "id": 10100007,
        "name": "65+"
      },
      {
        "id": 10199999,
        "name": "Unknown"
      }
    ],
    "totalRecords": 9,
    "filteredRecords": 9
  }
}

Get Language Segment​

GET /api/v2/master/segment/language

Get list of languages.

Response 200
{
  "statusCode": 200,
  "responseObject": {
    "data": [
      {
        "id": 10500007,
        "name": "Arabic"
      },
      {
        "id": 10500034,
        "name": "Chinese"
      },
      {
        "id": 10500048,
        "name": "English"
      },
      {
        "id": 10500056,
        "name": "French"
      },
      {
        "id": 10500063,
        "name": "German"
      },
      {
        "id": 10500098,
        "name": "Korean"
      },
      {
        "id": 10500147,
        "name": "Russian"
      },
      {
        "id": 10500164,
        "name": "Spanish"
      },
      {
        "id": 10500170,
        "name": "Tagalog"
      },
      {
        "id": 10500190,
        "name": "Vietnamese"
      },
      {
        "id": 10599998,
        "name": "Other"
      },
      {
        "id": 10599999,
        "name": "Unknown"
      }
    ],
    "totalRecords": 12,
    "filteredRecords": 12
  }
}

Get Interest Segment​

GET /api/v2/master/segment/interest

Get list of interests.

Response 200
{
    "statusCode": 200,
    "responseObject": {
        "data": [
            {
                "id": 10800042,
                "name": "Musical instruments"
            },
            {
                "id": 10800058,
                "name": "Woodworking"
            },
            {
                "id": 10800075,
                "name": "Gardening"
            },
            {
                "id": 10800081,
                "name": "Hunting"
            },
            {
                "id": 10800096,
                "name": "Photography"
            },
            {
                "id": 10800104,
                "name": "Shooting"
            },
            {
                "id": 10800180,
                "name": "Fishing"
            },
            {
                "id": 10800203,
                "name": "Tennis"
            },
            {
                "id": 10801317,
                "name": "Crafts "
            },
            {
                "id": 10801341,
                "name": "Golf "
            }
        ],
        "totalRecords": 58,
        "filteredRecords": 10
    }
}

Get Income Range Segment​

GET /api/v2/master/segment/income

Get list of income ranges.

Response 200
{
  "statusCode": 200,
  "responseObject": {
    "data": [
      {
        "id": 10300001,
        "name": "Less than $25000"
      },
      {
        "id": 10300002,
        "name": "$25001 - $50000"
      },
      {
        "id": 10300003,
        "name": "$50001 - $75000"
      },
      {
        "id": 10300004,
        "name": "$75001 - $100000"
      },
      {
        "id": 10300005,
        "name": "$100001 - $250000"
      },
      {
        "id": 10300006,
        "name": "$250000+"
      },
      {
        "id": 10399999,
        "name": "Unknown"
      }
    ],
    "totalRecords": 7,
    "filteredRecords": 7
  }
}

Get Ethnicity Segment​

GET /api/v2/master/segment/ethnicity

Get list of ethnicity IDs.

Response 200
{
  "statusCode": 200,
  "responseObject": {
    "data": [
      {
        "id": 10600001,
        "name": "Afghan",
        "parentId": 10799998
      },
      {
        "id": 10600002,
        "name": "African/American",
        "parentId": 10700003
      },
      {
        "id": 10600003,
        "name": "Albanian",
        "parentId": 10799998
      },
      {
        "id": 10600004,
        "name": "Aleut"
      },
      {
        "id": 10600005,
        "name": "Algerian"
      },
      {
        "id": 10600006,
        "name": "American",
        "parentId": 10799998
      },
      {
        "id": 10600007,
        "name": "Andorran"
      },
      {
        "id": 10600008,
        "name": "Angolan"
      },
      {
        "id": 10600009,
        "name": "Antiguans"
      },
      {
        "id": 10600010,
        "name": "Arab",
        "parentId": 10799998
      }
    ],
    "totalRecords": 219,
    "filteredRecords": 10
  }
}

Get Ethnicity Group Segment​

GET /api/v2/master/segment/ethnicity-group

Get list of ethnicity group IDs.

Response 200
{
  "statusCode": 200,
  "responseObject": {
    "data": [
      {
        "id": 10700001,
        "name": "European"
      },
      {
        "id": 10700002,
        "name": "Hispanic"
      },
      {
        "id": 10700003,
        "name": "African-American"
      },
      {
        "id": 10700004,
        "name": "Asian"
      },
      {
        "id": 10799998,
        "name": "Other"
      },
      {
        "id": 10799999,
        "name": "Unknown"
      }
    ],
    "totalRecords": 6,
    "filteredRecords": 6
  }
}

Get DMA Code Segment​

POST /api/v3/master/segment/dma

Get list of Designated Market Area Codes.

Properties
id
integer		DMA ID
name
string		DMA name
abbreviation
string		DMA code
parentId
integer		State ID
geojsonUrl
string		Json geographical data URL
Request Sample
{
  "pageNo": 1,
  "noOfEntries": 10,
  "sortBy": "+id",
  "searchField": "",
  "segmentIds": [],
  "ids": []
}
Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 30900001,
        "name": "Portland-Auburn, ME",
        "abbreviation": "500",
        "parentId": 30200022,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/dmadata/geojson/US/ME/500.geojson"
      },
      {
        "id": 30900002,
        "name": "New York, NY",
        "abbreviation": "501",
        "parentId": 30200035,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/dmadata/geojson/US/NY/501.geojson"
      },
      {
        "id": 30900003,
        "name": "Binghamton, NY",
        "abbreviation": "502",
        "parentId": 30200035,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/dmadata/geojson/US/NY/502.geojson"
      },
      {
        "id": 30900004,
        "name": "Macon, GA",
        "abbreviation": "503",
        "parentId": 30200011,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/dmadata/geojson/US/GA/503.geojson"
      },
      {
        "id": 30900005,
        "name": "Philadelphia, PA",
        "abbreviation": "504",
        "parentId": 30200039,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/dmadata/geojson/US/PA/504.geojson"
      },
      {
        "id": 30900006,
        "name": "Detroit, MI",
        "abbreviation": "505",
        "parentId": 30200023,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/dmadata/geojson/US/MI/505.geojson"
      },
      {
        "id": 30900007,
        "name": "Boston, MA-Manchester, NH",
        "abbreviation": "506",
        "parentId": 30200031,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/dmadata/geojson/US/NH/506.geojson"
      },
      {
        "id": 30900008,
        "name": "Savannah, GA",
        "abbreviation": "507",
        "parentId": 30200011,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/dmadata/geojson/US/GA/507.geojson"
      },
      {
        "id": 30900009,
        "name": "Pittsburgh, PA",
        "abbreviation": "508",
        "parentId": 30200039,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/dmadata/geojson/US/PA/508.geojson"
      },
      {
        "id": 30900010,
        "name": "Ft. Wayne, IN",
        "abbreviation": "509",
        "parentId": 30200016,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/dmadata/geojson/US/IN/509.geojson"
      }
    ],
    "totalRecords": 210,
    "filteredRecords": 210
  }
}

Get County Segment​

POST /api/v3/master/segment/county

Get list of county segment.

Properties
id
integer		County ID
name
string		County name
parentId
integer		State ID
geojsonUrl
string		Json geographical data URL
Request Sample
{
  "pageNo": 1,
  "noOfEntries": 10,
  "sortBy": "+id",
  "searchField": "",
  "segmentIds": [],
  "ids": []
}
Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 30300001,
        "name": "Aleutians East, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/countydata/US/AK/geojson/30300001.geojson"
      },
      {
        "id": 30300002,
        "name": "Aleutians West, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/countydata/US/AK/geojson/30300002.geojson"
      },
      {
        "id": 30300003,
        "name": "Anchorage, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/countydata/US/AK/geojson/30300003.geojson"
      },
      {
        "id": 30300004,
        "name": "Bethel, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/countydata/US/AK/geojson/30300004.geojson"
      },
      {
        "id": 30300005,
        "name": "Bristol Bay, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/countydata/US/AK/geojson/30300005.geojson"
      },
      {
        "id": 30300006,
        "name": "Denali, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/countydata/US/AK/geojson/30300006.geojson"
      },
      {
        "id": 30300007,
        "name": "Dillingham, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/countydata/US/AK/geojson/30300007.geojson"
      },
      {
        "id": 30300008,
        "name": "Fairbanks North Star, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/countydata/US/AK/geojson/30300008.geojson"
      },
      {
        "id": 30300009,
        "name": "Haines, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/countydata/US/AK/geojson/30300009.geojson"
      },
      {
        "id": 30300010,
        "name": "Hoonah Angoon, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/countydata/US/AK/geojson/30300010.geojson"
      }
    ],
    "totalRecords": 3142,
    "filteredRecords": 3142
  }
}

Get Country Segment​

POST /api/v3/master/segment/country

Get list of country segment.

Properties
id
integer		County ID
name
string		County name
abbreviation
integer		Country Abbreviation
Request Sample
{
  "pageNo": 1,
  "noOfEntries": 10,
  "sortBy": "+id",
  "searchField": "",
  "segmentIds": [],
  "ids": []
}
Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 30100001,
        "name": "United States",
        "abbreviation": "US"
      },
      {
        "id": 30100002,
        "name": "India",
        "abbreviation": "IN"
      },
      {
        "id": 30100011,
        "name": "Afghanistan",
        "abbreviation": "AF"
      },
      {
        "id": 30100013,
        "name": "Albania",
        "abbreviation": "AL"
      },
      {
        "id": 30100014,
        "name": "Algeria",
        "abbreviation": "DZ"
      },
      {
        "id": 30100016,
        "name": "Andorra",
        "abbreviation": "AD"
      },
      {
        "id": 30100017,
        "name": "Angola",
        "abbreviation": "AO"
      },
      {
        "id": 30100020,
        "name": "Antigua and Barbuda",
        "abbreviation": "AG"
      },
      {
        "id": 30100021,
        "name": "Argentina",
        "abbreviation": "AR"
      },
      {
        "id": 30100022,
        "name": "Armenia",
        "abbreviation": "AM"
      }
    ],
    "totalRecords": 249,
    "filteredRecords": 249
  }
}

Get Congressional District Segment​

POST /api/v3/master/segment/congressional-district

Get list of congressional district segment.

Properties
id
integer		County ID
name
string		County name
abbreviation
integer		Country Abbreviation
parentId
integer		State ID
geojsonUrl
string		Json geographical data URL
Request Sample
{
  "pageNo": 1,
  "noOfEntries": 10,
  "sortBy": "+id",
  "searchField": "",
  "segmentIds": [],
  "ids": []
}
Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 30600502,
        "name": "Alabama-1",
        "abbreviation": "AL-1",
        "parentId": 30200002,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/cd/AL/30600502.geojson"
      },
      {
        "id": 30600503,
        "name": "Alabama-2",
        "abbreviation": "AL-2",
        "parentId": 30200002,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/cd/AL/30600503.geojson"
      },
      {
        "id": 30600504,
        "name": "Alabama-3",
        "abbreviation": "AL-3",
        "parentId": 30200002,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/cd/AL/30600504.geojson"
      },
      {
        "id": 30600505,
        "name": "Alabama-4",
        "abbreviation": "AL-4",
        "parentId": 30200002,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/cd/AL/30600505.geojson"
      },
      {
        "id": 30600506,
        "name": "Alabama-5",
        "abbreviation": "AL-5",
        "parentId": 30200002,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/cd/AL/30600506.geojson"
      },
      {
        "id": 30600507,
        "name": "Alabama-6",
        "abbreviation": "AL-6",
        "parentId": 30200002,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/cd/AL/30600507.geojson"
      },
      {
        "id": 30600508,
        "name": "Alabama-7",
        "abbreviation": "AL-7",
        "parentId": 30200002,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/cd/AL/30600508.geojson"
      },
      {
        "id": 30601009,
        "name": "Arkansas-1",
        "abbreviation": "AR-1",
        "parentId": 30200003,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/cd/AR/30601009.geojson"
      },
      {
        "id": 30601010,
        "name": "Arkansas-2",
        "abbreviation": "AR-2",
        "parentId": 30200003,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/cd/AR/30601010.geojson"
      },
      {
        "id": 30601011,
        "name": "Arkansas-3",
        "abbreviation": "AR-3",
        "parentId": 30200003,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/districtdata/geojson/cd/AR/30601011.geojson"
      }
    ],
    "totalRecords": 429,
    "filteredRecords": 429
  }
}

Get City Segment​

POST /api/v3/master/segment/city

Get list of city segment.

Properties
id
integer		City ID
name
string		City name
parentId
integer		State ID
geojsonUrl
string		Json geographical data URL
Request Sample
{
  "pageNo": 1,
  "noOfEntries": 10,
  "sortBy": "+id",
  "searchField": "",
  "segmentIds": [],
  "ids": []
}
Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 30400001,
        "name": "Adak, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/citydata/US/AK/geojson/30400001.geojson"
      },
      {
        "id": 30400002,
        "name": "Akhiok, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/citydata/US/AK/geojson/30400002.geojson"
      },
      {
        "id": 30400003,
        "name": "Akiachak, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/citydata/US/AK/geojson/30400003.geojson"
      },
      {
        "id": 30400004,
        "name": "Akiak, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/citydata/US/AK/geojson/30400004.geojson"
      },
      {
        "id": 30400005,
        "name": "Akutan, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/citydata/US/AK/geojson/30400005.geojson"
      },
      {
        "id": 30400006,
        "name": "Alakanuk, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/citydata/US/AK/geojson/30400006.geojson"
      },
      {
        "id": 30400007,
        "name": "Aleknagik, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/citydata/US/AK/geojson/30400007.geojson"
      },
      {
        "id": 30400008,
        "name": "Allakaket, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/citydata/US/AK/geojson/30400008.geojson"
      },
      {
        "id": 30400009,
        "name": "Ambler, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/citydata/US/AK/geojson/30400009.geojson"
      },
      {
        "id": 30400010,
        "name": "Anaktuvuk Pass, AK",
        "parentId": 30200001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/citydata/US/AK/geojson/30400010.geojson"
      }
    ],
    "totalRecords": 38130,
    "filteredRecords": 38130
  }
}

Get Location Types​

GET /api/v3/master/segment/locationtype

Get a list of location types.

Response 200
{
  "success": true,
  "data": [
    {
      "id": 302,
      "name": "State",
      "order": 1
    },
    {
      "id": 309,
      "name": "DMA",
      "order": 2
    },
    {
      "id": 303,
      "name": "County",
      "order": 3
    },
    {
      "id": 304,
      "name": "City",
      "order": 4
    },
    {
      "id": 306,
      "name": "Congressional District",
      "order": 5
    },
    {
      "id": 307,
      "name": "State Senate",
      "order": 6
    },
    {
      "id": 308,
      "name": "State House",
      "order": 7
    }
  ]
}

Get Location Details by Location Type​

GET /api/v3/master/segment/locationtype-details

Get location details by location type and search filters.

Query Parameters
searchField
string		Search the result by keyword
locationTypeIds
string		Filters result by location type IDs, comma separated
Response 200
{
  "success": true,
  "data": {
    "302": [
      {
        "id": 30200038,
        "name": "Oregon",
        "abbreviation": "OR",
        "parentId": 30100001,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/statedata/OR.geojson"
      }
  ],
  "303": [
      {
        "id": 30320708,
        "name": "Baker, OR",
        "parentId": 30200038,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/countydata/US/OR/geojson/30320708.geojson"
      }
      {
        "id": 30320709,
        "name": "Benton, OR",
        "parentId": 30200038,
        "geojsonUrl": "https://d3jme5si7t6llb.cloudfront.net/countydata/US/OR/geojson/30320709.geojson"
      }
      ...
    ]
  }
}
More Responses
Response 422
{
  "success": false,
  "errorObjects": [
    {
      "error": "Invalid location type ids"
    }
  ]
}

Get Timezones​

GET /api/v3/master/timezones

Get a static list of timezone IDs.

Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "name": "US/Central",
        "id": 423,
        "label": "US/Central"
      },
      {
        "name": "US/Eastern",
        "id": 29,
        "label": "US/Eastern"
      },
      {
        "name": "US/Mountain",
        "id": 21,
        "label": "US/Mountain"
      }
      ...
    ]
  }
}

Get Carriers and States by Country ID​

GET /api/countries/{country_id}/carriers
GET /api/countries/{country_id}/states

Get a list of carriers or states by country ID.

Path Parameters
country_id
string		Country ID
Response 200 (carriers)
[
  {
    "id": 292,
    "name": "AT&T Mobility",
    "country_id": 246
  },
  {
    "id": 293,
    "name": "AT&T WiFi",
    "country_id": 246
  },
  {
    "id": 294,
    "name": "Cable Vision WiFi",
    "country_id": 246
  },
  {
    "id": 295,
    "name": "Cellular One",
    "country_id": 246
  },
  {
    "id": 296,
    "name": "Cellular South",
    "country_id": 246
  },
  {
    "id": 297,
    "name": "Charter WiFi",
    "country_id": 246
  },
  {
    "id": 298,
    "name": "Cincinnati Bell US",
    "country_id": 246
  },
  {
    "id": 299,
    "name": "Cox Communications",
    "country_id": 246
  },
  {
    "id": 300,
    "name": "Cricket",
    "country_id": 246
  },
  {
    "id": 301,
    "name": "Earthlink",
    "country_id": 246
  },
  ...
]

Get Creative Data​

The following endpoints can be used to get details and specs on various Creative properties and lists. Most support paginated query parameters:

Query Parameters
pageNo
integer required		Page number for the required data, default: 1
limit
integer required		The maximum number of returned results per page, default: 300
sortBy
string optional		Sort the result set by specific field. For ascending use plus(+) sign and for descending use minus(-) sign, default: +id
searchField
string optional		Search the result by provided keyword in the searchField, search country records by name
ids
array of integers optional		Selected country ID List, countries with provided ids will be returned first compared to other records
segmentIds
array of integers optional		Filters for property segment IDs

Get Creative Types​

GET /api/v3/master/static/creative-types

Get a list of Creative types.

Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "name": "Image",
        "rtbCampaignTypeId": 1,
        "id": 11
      },
      {
        "name": "HTML",
        "rtbCampaignTypeId": 1,
        "id": 13
      },
      {
        "name": "Video",
        "rtbCampaignTypeId": 3,
        "id": 14
      },
      {
        "name": "Native",
        "rtbCampaignTypeId": 4,
        "id": 15
      },
      {
        "name": "Audio",
        "rtbCampaignTypeId": 2,
        "id": 17
      }
    ],
    "totalRecords": 5,
    "filteredRecords": 5
  }
}

Get RTB Creative Types​

GET /api/v3/master/rtb-creative-types

Get list of RTB Creative types.

Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "name": "Banner",
        "id": 1
      },
      {
        "name": "Audio",
        "id": 2
      },
      {
        "name": "Video",
        "id": 3
      },
      {
        "name": "Native",
        "id": 4
      }
    ],
    "totalRecords": 4,
    "filteredRecords": 4
  }
}

Get Creative sizes​

GET /api/v3/master/creative-sizes

Get list of Creative sizes.

Response 200
{
  "success": true,
  "data": {
    "standardDimensions": [
      {
        "name": "320x50",
        "id": 1
      },
      {
        "name": "300x250",
        "id": 2
      },
      {
        "name": "728x90",
        "id": 3
      },
      ...
  ],
  "creativeDurations": [
      {
        "name": "Below 15s",
        "id": 1
      },
      {
        "name": "Up to 15s",
        "id": 2
      },
      {
        "name": "Up to 30s",
        "id": 3
      },
      ...
  ],
  "videoPlayerSizes": [
      {
        "name": "Small",
        "id": 1
      },
      {
        "name": "Large",
        "id": 3
      },
      {
        "name": "HD",
        "id": 4
      }
    ]
  }
}

Get Video Skip Parameters​

GET /api/v3/master/ccreative/video/skippability

Get list of video skippability parameters.

Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 20900001,
        "name": "Skippable"
      },
      {
        "id": 20900002,
        "name": "Non-Skippable"
      },
      {
        "id": 20999999,
        "name": "Unknown"
      }
  ],
    "totalRecords": 3,
    "filteredRecords": 3
  }
}

Get Video Roll Position Parameters​

GET /api/v3/master/creative/video/roll-position

Get list of video roll position parameters.

Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 20700001,
        "name": "Pre-Roll"
      },
      {
        "id": 20700002,
        "name": "Mid-Roll"
      },
      {
        "id": 20700003,
        "name": "Post-Roll"
      },
      {
        "id": 20799999,
        "name": "Unknown"
      }
    ],
    "totalRecords": 4,
    "filteredRecords": 4
  }
}

Get Video Player Size Parameters​

GET /api/v3/master/creative/video/player-size

Get list of video player size parameters.

Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 20800001,
        "name": "Medium & Big"
      },
      {
        "id": 20800002,
        "name": "Small"
      },
      {
        "id": 20899999,
        "name": "Unknown"
      }
    ],
    "totalRecords": 3,
    "filteredRecords": 3
  }
}

Get Video Playback Method Parameters​

GET /api/v3/master/creative/video/playback-method

Get list of video playback method parameters.

Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 21000001,
        "name": "Sound On"
      },
      {
        "id": 21000002,
        "name": "Mute"
      },
      {
        "id": 21099999,
        "name": "Unknown"
      }
    ],
    "totalRecords": 3,
    "filteredRecords": 3
  }
}

Get Video Placement Type Parameters​

GET /api/v3/master/creative/video/placement-type

Get a list of video placement type parameters.

Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 20600001,
        "name": "In-Stream"
      },
      {
        "id": 20600002,
        "name": "Out-Stream"
      },
      {
        "id": 20699999,
        "name": "Unknown"
      }
    ],
    "totalRecords": 3,
    "filteredRecords": 3
  }
}

Get More Data​

Get Network Types for targeting​

GET /api/network_types

Get list of network types for targeting.

Response 200
[
  {
    "name": "Mobile",
    "id": 13
  },
  {
    "name": "WIFI",
    "id": 12
  }
]

Get Device OS for targeting​

GET /api/device_os
GET /api/v2/master/segment/device-os

Get list of device OS for targeting.

The following query paramters are supported by the /api/v2/master/segment/device-os endpoint.

Query Parameters
pageNo
integer		Page number for the required data, default: 1
noOfEntries
integer		The maximum number of returned results per page, default: 20
sortBy
string		Sort the result set by specific field. For ascending use plus(+) sign and for descending use minus(-) sign, default: +id
order
string		Sort by ascending (asc) or descending (desc)
searchField
string		Search the result by provided keyword in the searchField, search country records by name
ids
array of integers		Selected segment ID List, segments with provided IDs will be returned first compared to other records
segmentIds
array of integers		Filters for property segment IDs
campaignId
integer		Segment list by Campaign ID
Response 200 (device_os)
[
  {
    "name": "Android",
    "id": 11
  },
  {
    "name": "iOS",
    "id": 12
  },
  {
    "name": "Windows",
    "id": 13
  },
  {
    "name": "BlackBerry",
    "id": 14
  },
  {
    "name": "Roku",
    "id": 15
  },
  {
    "name": "IPTV",
    "id": 16
  },
  {
    "name": "Desktop",
    "id": 17
  }
]

Get Manufacturers for Targeting​

GET /api/v2/master/segment/device-manufacturer

Get list of manufacturers for targeting.

Query Parameters
pageNo
integer required		Page number for the required data, default: 1
noOfEntries
integer required		The maximum number of returned results per page, default: 20
sortBy
string		Sort the result set by specific field. For ascending use plus(+) sign and for descending use minus(-) sign, default: +id
order
string		Sort by ascending (asc) or descending (desc)
searchField
string		Search the result by provided keyword in the searchField, search country records by name
ids
array of integers		Selected segment ID List, segments with provided IDs will be returned first compared to other records
segmentIds
array of integers		Filters for property segment IDs
campaignId
integer		Segment list by Campaign ID
Response 200
{
  "statusCode": 200,
  "responseObject": {
    "data": [
      {
        "id": 20100001,
        "name": "AT&T"
      },
      {
        "id": 20100002,
        "name": "Alcatel"
      },
      {
        "id": 20100003,
        "name": "Amazon"
      },
      {
        "id": 20100004,
        "name": "Apple"
      },
      {
        "id": 20100005,
        "name": "Asus"
      },
      {
        "id": 20100006,
        "name": "BLU"
      },
      {
        "id": 20100007,
        "name": "Barnes and Noble"
      },
      {
        "id": 20100008,
        "name": "BlackBerry"
      },
      {
        "id": 20100009,
        "name": "Canonical"
      },
      {
        "id": 20100010,
        "name": "Comcast"
      }
    ],
    "totalRecords": 535,
    "filteredRecords": 535
  }
}

Get Channels for Inventory​

GET /api/v3/master/segment/channel

Get list of channels for Inventory app.

Query Parameters
pageNo
integer required		Page number for the required data, default: 1
limit
integer required		The maximum number of returned results per page, default: 20
sortBy
string		Sort the result set by specific field. For ascending use plus(+) sign and for descending use minus(-) sign, default: +id
order
string		Sort by ascending (asc) or descending (desc)
searchField
string		Search the result by provided keyword in the searchField, search country records by name
ids
array of integers		Selected segment ID List, segments with provided IDs will be returned first compared to other records
segmentIds
array of integers		Filters for property segment IDs
Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 21100001,
        "name": "App"
      },
      {
        "id": 21100002,
        "name": "OTT App"
      },
      {
        "id": 21100003,
        "name": "Web"
      }
    ],
    "totalRecords": 3,
    "filteredRecords": 3
  }
}

Get verticals​

GET /api/v3/master/verticals/list

Get list of verticals values.

Response 200
{
  "success": true,
  "data": {
    "verticalsList": [
      {
        "name": "political",
        "id": 1,
        "label": "Political",
        "order": 1
      },
      {
        "name": "healthcare",
        "id": 2,
        "label": "Healthcare",
        "order": 2
      },
      {
        "name": "travel",
        "id": 3,
        "label": "Travel",
        "order": 3
      },
      {
        "name": "retail",
        "id": 4,
        "label": "Retail",
        "order": 4
      },
      {
        "name": "b2b",
        "id": 5,
        "label": "B2B",
        "order": 5
      },
      {
        "name": "finance",
        "id": 6,
        "label": "Finance",
        "order": 6
      },
      {
        "name": "sensitive",
        "id": 7,
        "label": "Sensitive",
        "order": 7
      },
      {
        "name": "other",
        "id": 8,
        "label": "Other",
        "order": 8
      }
    ]
  }
}

Get Traffic Types​

GET /api/v3/master/traffic-types

Get list of traffic types.

Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 11,
        "name": "App",
        "isTvAd": false
      },
      {
        "id": 14,
        "name": "CTV",
        "isTvAd": true
      },
      {
        "id": 13,
        "name": "OTT",
        "isTvAd": true
      },
      {
        "id": 12,
        "name": "Web",
        "isTvAd": false
      }
    ],
    "totalRecords": 4,
    "filteredRecords": 4
  }
}

Get Inventory Types​

GET /api/v3/master/inventory-types

Get list of Inventory types.

Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "name": "Site",
        "id": 1
      },
      {
        "name": "Android App",
        "id": 2
      },
      {
        "name": "IOS App",
        "id": 3
      },
      {
        "name": "Other App",
        "id": 99
      }
    ],
    "totalRecords": 4,
    "filteredRecords": 4
  }
  }

Get Exchanges​

GET /api/v3/master/exchanges

Get list of exchanges.

Query Parameters
pageNo
integer		Page number for the required data, default: 1
noOfEntries
integer		The maximum number of returned results per page, default: 20
sortBy
string		Sort the result set by specific field. For ascending use plus(+) sign and for descending use minus(-) sign, default: +id
order
string		Sort by ascending (asc) or descending (desc)
searchField
string		Search the result by provided keyword in the searchField, search country records by name
ids
array of integers		Selected segment ID List, segments with provided IDs will be returned first compared to other records
exchangeIds
array of integers		Filters for exchange IDs
Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 90,
        "name": "Aniview",
        "urlName": "aniview"
      },
      {
        "id": 89,
        "name": "LoopMe",
        "urlName": "loopme"
      },
      {
        "id": 88,
        "name": "One Tag",
        "urlName": "onetag"
      },
      {
        "id": 87,
        "name": "Share Through",
        "urlName": "sharethrough"
      },
      {
        "id": 84,
        "name": "Vidazoo",
        "urlName": "vidazoo"
      },
      {
        "id": 80,
        "name": "Equativ",
        "urlName": "equativ"
      },
      {
        "id": 78,
        "name": "Magnite",
        "urlName": "magnite"
      },
      {
        "id": 77,
        "name": "Verve",
        "urlName": "verve"
      },
      {
        "id": 76,
        "name": "Infolink",
        "urlName": "infolink"
      },
      {
        "id": 75,
        "name": "Beachfront",
        "urlName": "beachfront"
      },
    ],
    "totalRecords": 26,
    "filteredRecords": 10
  }
}

Get Deal Curation Types​

GET api/v3/master/deal-curation-type

Get list of deal curation types.

Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "name": "Standard",
        "id": 4
      },
      {
        "name": "Tailored",
        "id": 5
      },
      {
        "name": "Open Exchange",
        "id": 6
      }
    ],
    "totalRecords": 3,
    "filteredRecords": 3
  }
}

Get Publisher Ad categories​

POST /api/v3/master/adcategories

Get list of publisher ad categories.

Request Schema
pageNo
integer required		Page number for returned data, default: 1
noOfEntries
integer required		Maximum number of returned results per page
sortBy
string optional		Sort the results by specific field. For ascending use plus(+) and for descending use minus(-) sign. Default value: -id
searchField
string optional		Search the result by provided keyword
ids
array of integers optional		Filter for specified IDs, matches will be returned first compared to other records
adCategoryIds
array of integers		Filter for ad category IDs
Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 12,
        "name": "Books & Literature (IAB1-1)",
        "parentId": 11,
        "iabCategoryId": "IAB1-1",
        "parentName": "Arts & Entertainment"
      },
      {
        "id": 13,
        "name": "Celebrity Fan/Gossip (IAB1-2)",
        "parentId": 11,
        "iabCategoryId": "IAB1-2",
        "parentName": "Arts & Entertainment"
      },
      {
        "id": 14,
        "name": "Fine Art (IAB1-3)",
        "parentId": 11,
        "iabCategoryId": "IAB1-3",
        "parentName": "Arts & Entertainment"
      },
      {
        "id": 15,
        "name": "Humor (IAB1-4)",
        "parentId": 11,
        "iabCategoryId": "IAB1-4",
        "parentName": "Arts & Entertainment"
      },
      {
        "id": 16,
        "name": "Movies (IAB1-5)",
        "parentId": 11,
        "iabCategoryId": "IAB1-5",
        "parentName": "Arts & Entertainment"
      },
      {
        "id": 17,
        "name": "Music (IAB1-6)",
        "parentId": 11,
        "iabCategoryId": "IAB1-6",
        "parentName": "Arts & Entertainment"
      },
      {
        "id": 18,
        "name": "Television (IAB1-7)",
        "parentId": 11,
        "iabCategoryId": "IAB1-7",
        "parentName": "Arts & Entertainment"
      },
      {
        "id": 20,
        "name": "Auto Parts (IAB2-1)",
        "parentId": 19,
        "iabCategoryId": "IAB2-1",
        "parentName": "Automotive"
      },
      {
        "id": 21,
        "name": "Auto Repair (IAB2-2)",
        "parentId": 19,
        "iabCategoryId": "IAB2-2",
        "parentName": "Automotive"
      },
      {
        "id": 22,
        "name": "Buying/Selling Cars (IAB2-3)",
        "parentId": 19,
        "iabCategoryId": "IAB2-3",
        "parentName": "Automotive"
      }
    ],
    "totalRecords": 364,
    "filteredRecords": 364
  }
}

Get Device Type​

POST /api/v3/master/segment/device-type

Get list of device types.

Request Schema
pageNo
integer required		Page number for returned data, default: 1
noOfEntries
integer required		Maximum number of returned results per page
sortBy
string optional		Sort the results by specific field. For ascending use plus(+) and for descending use minus(-) sign. Default value: -id
searchField
string optional		Search the result by provided keyword
ids
array of integers optional		Filter for specified IDs, matches will be returned first compared to other records
segmentIds
array of integers		Filters by device type IDs
Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "name": "Mobile",
        "id": 20300001
      },
      {
        "name": "Desktop",
        "id": 20300002
      },
      {
        "name": "Connected TV",
        "id": 20300003
      },
      {
        "name": "Tablet",
        "id": 20300004
      },
      {
        "name": "Unknown",
        "id": 20399999
      }
    ],
    "totalRecords": 5,
    "filteredRecords": 5
  }
}

Get Inventory​

POST /api/v3/master/inventory

Get master Inventory list.

Request Schema
pageNo
integer required		Page number for returned data, default: 1
noOfEntries
integer required		Maximum number of returned results per page
sortBy
string optional		Sort the results by specific field. For ascending use plus(+) and for descending use minus(-) sign. Default value: -id
searchField
string optional		Search the result by provided keyword
ids
array of integers optional		Filter for specified IDs, matches will be returned first compared to other records
publisherIds
array of integers		Filters for publisher IDs
inventoryIds
array of integers		Filters for Inventory IDs
Response 200
{
  "success": true,
  "data": {
    "data": [
      {
        "id": 0,
        "publisherId": 0,
        "trafficType": "UN",
        "name": "UNKNOWN",
        "bundleDomain": ""
      },
      {
        "id": 1,
        "publisherId": 1,
        "trafficType": "web",
        "name": "1.philantropy.xyz",
        "bundleDomain": "1.philantropy.xyz"
      },
      {
        "id": 2,
        "publisherId": 2,
        "trafficType": "web",
        "name": "1010wins.radio.com",
        "bundleDomain": "1010wins.radio.com"
      },
      {
        "id": 3,
        "publisherId": 3,
        "trafficType": "web",
        "name": "10faq.com",
        "bundleDomain": "10faq.com"
      },
      {
        "id": 4,
        "publisherId": 4,
        "trafficType": "web",
        "name": "11alive.com",
        "bundleDomain": "11alive.com"
      },
      {
        "id": 5,
        "publisherId": 5,
        "trafficType": "web",
        "name": "123greetings.com",
        "bundleDomain": "123greetings.com"
      },
      {
        "id": 6,
        "publisherId": 6,
        "trafficType": "web",
        "name": "12tomatoes.com",
        "bundleDomain": "12tomatoes.com"
      },
      {
        "id": 7,
        "publisherId": 7,
        "trafficType": "web",
        "name": "13wham.com",
        "bundleDomain": "13wham.com"
      },
      {
        "id": 8,
        "publisherId": 8,
        "trafficType": "web",
        "name": "1stkissmanga.com",
        "bundleDomain": "1stkissmanga.com"
      },
      {
        "id": 9,
        "publisherId": 9,
        "trafficType": "web",
        "name": "247freecell.com",
        "bundleDomain": "247freecell.com"
      }
    ],
    "totalRecords": 7962640,
    "filteredRecords": 7962640
  }
}