Connected TV

Reference catalogs for the CTV dataset. Every read here is authenticated and JSON-only (bearer token + Accept: application/json) and uses the read rate bucket (120 requests/min per caller).

The vendor / content type / content genre / channel name reads are flat lists of { value, text } pairs (the value is the name you pass to the CTV audience filters). The device type / make / OS, connection type, ISP and series reads are paginated and searchable. Every CTV filter is optional in the audience create body - leave one un-selected to select all.

Get Vendors

GET /api/v2/analyses/reference/ctv/vendors

CTV vendors.

Query parameters

Field	Type	Required	Description
`search`	string	No	Optional free-text filter on the item label (case-insensitive contains).

curl "https://console.intuizi.com/api/v2/analyses/reference/ctv/vendors" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"

import requests

res = requests.get(
    "https://console.intuizi.com/api/v2/analyses/reference/ctv/vendors",
    headers={"Authorization": "Bearer <YOUR_TOKEN>", "Accept": "application/json"},
)
vendors = res.json()["data"]

const res = await fetch(
  "https://console.intuizi.com/api/v2/analyses/reference/ctv/vendors",
  { headers: { Authorization: "Bearer <YOUR_TOKEN>", Accept: "application/json" } }
);
const vendors = (await res.json()).data;

Response

{
  "status": "success",
  "code": 200,
  "message": "Resources fetched successfully.",
  "data": [
    { "value": "Roku", "text": "Roku" }
  ]
}

Get Content Types

GET /api/v2/analyses/reference/ctv/content-types

CTV content types.

Query parameters

Field	Type	Required	Description
`search`	string	No	Optional free-text filter on the item label (case-insensitive contains).

curl "https://console.intuizi.com/api/v2/analyses/reference/ctv/content-types" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"

import requests

res = requests.get(
    "https://console.intuizi.com/api/v2/analyses/reference/ctv/content-types",
    headers={"Authorization": "Bearer <YOUR_TOKEN>", "Accept": "application/json"},
)
content_types = res.json()["data"]

const res = await fetch(
  "https://console.intuizi.com/api/v2/analyses/reference/ctv/content-types",
  { headers: { Authorization: "Bearer <YOUR_TOKEN>", Accept: "application/json" } }
);
const contentTypes = (await res.json()).data;

Response

{
  "status": "success",
  "code": 200,
  "message": "Resources fetched successfully.",
  "data": [
    { "value": "Movie", "text": "Movie" }
  ]
}

Get Content Genres

GET /api/v2/analyses/reference/ctv/content-genres

CTV content genres.

Query parameters

Field	Type	Required	Description
`search`	string	No	Optional free-text filter on the item label (case-insensitive contains).

curl "https://console.intuizi.com/api/v2/analyses/reference/ctv/content-genres" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"

import requests

res = requests.get(
    "https://console.intuizi.com/api/v2/analyses/reference/ctv/content-genres",
    headers={"Authorization": "Bearer <YOUR_TOKEN>", "Accept": "application/json"},
)
genres = res.json()["data"]

const res = await fetch(
  "https://console.intuizi.com/api/v2/analyses/reference/ctv/content-genres",
  { headers: { Authorization: "Bearer <YOUR_TOKEN>", Accept: "application/json" } }
);
const genres = (await res.json()).data;

Response

{
  "status": "success",
  "code": 200,
  "message": "Resources fetched successfully.",
  "data": [
    { "value": "Comedy", "text": "Comedy" }
  ]
}

Get Channel Names

GET /api/v2/analyses/reference/ctv/channel-names

CTV channel names.

Query parameters

Field	Type	Required	Description
`search`	string	No	Optional free-text filter on the item label (case-insensitive contains).

curl "https://console.intuizi.com/api/v2/analyses/reference/ctv/channel-names" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"

import requests

res = requests.get(
    "https://console.intuizi.com/api/v2/analyses/reference/ctv/channel-names",
    headers={"Authorization": "Bearer <YOUR_TOKEN>", "Accept": "application/json"},
)
channels = res.json()["data"]

const res = await fetch(
  "https://console.intuizi.com/api/v2/analyses/reference/ctv/channel-names",
  { headers: { Authorization: "Bearer <YOUR_TOKEN>", Accept: "application/json" } }
);
const channels = (await res.json()).data;

Response

{
  "status": "success",
  "code": 200,
  "message": "Resources fetched successfully.",
  "data": [
    { "value": "ABC", "text": "ABC" }
  ]
}

Get Device Types

GET /api/v2/analyses/reference/ctv/device-types

CTV device type names, paginated and searchable. Each item is a { value, text } pair - use the value in the matching audience create field.

Query parameters

Field	Type	Required	Description
`page`	integer	No	Page to fetch. Defaults to 1.
`per_page`	integer	No	Items per page. Defaults to 500, capped at 500.
`search`	string	No	Free-text search on the item name (case-insensitive contains).

curl "https://console.intuizi.com/api/v2/analyses/reference/ctv/device-types?search=smart" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"

import requests

res = requests.get(
    "https://console.intuizi.com/api/v2/analyses/reference/ctv/device-types",
    headers={"Authorization": "Bearer <YOUR_TOKEN>", "Accept": "application/json"},
    params={"search": "smart"},
)
page = res.json()["data"]

const res = await fetch(
  "https://console.intuizi.com/api/v2/analyses/reference/ctv/device-types?search=smart",
  { headers: { Authorization: "Bearer <YOUR_TOKEN>", Accept: "application/json" } }
);
const page = (await res.json()).data;

Response

{
  "status": "success",
  "code": 200,
  "message": "Resources fetched successfully.",
  "data": {
    "items": [
      { "value": "Example", "text": "Example" }
    ],
    "pagination": { "current_page": 1, "per_page": 500, "total": 1, "last_page": 1 }
  }
}

Get Device Makes

GET /api/v2/analyses/reference/ctv/device-makes

CTV device make names, paginated and searchable. Each item is a { value, text } pair - use the value in the matching audience create field.

Query parameters

Field	Type	Required	Description
`page`	integer	No	Page to fetch. Defaults to 1.
`per_page`	integer	No	Items per page. Defaults to 500, capped at 500.
`search`	string	No	Free-text search on the item name (case-insensitive contains).

curl "https://console.intuizi.com/api/v2/analyses/reference/ctv/device-makes?search=samsung" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"

import requests

res = requests.get(
    "https://console.intuizi.com/api/v2/analyses/reference/ctv/device-makes",
    headers={"Authorization": "Bearer <YOUR_TOKEN>", "Accept": "application/json"},
    params={"search": "samsung"},
)
page = res.json()["data"]

const res = await fetch(
  "https://console.intuizi.com/api/v2/analyses/reference/ctv/device-makes?search=samsung",
  { headers: { Authorization: "Bearer <YOUR_TOKEN>", Accept: "application/json" } }
);
const page = (await res.json()).data;

Response

{
  "status": "success",
  "code": 200,
  "message": "Resources fetched successfully.",
  "data": {
    "items": [
      { "value": "Example", "text": "Example" }
    ],
    "pagination": { "current_page": 1, "per_page": 500, "total": 1, "last_page": 1 }
  }
}

Get Device OSes

GET /api/v2/analyses/reference/ctv/device-oses

CTV device OS names, paginated and searchable. Each item is a { value, text } pair - use the value in the matching audience create field.

Query parameters

Field	Type	Required	Description
`page`	integer	No	Page to fetch. Defaults to 1.
`per_page`	integer	No	Items per page. Defaults to 500, capped at 500.
`search`	string	No	Free-text search on the item name (case-insensitive contains).

curl "https://console.intuizi.com/api/v2/analyses/reference/ctv/device-oses?search=tizen" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"

import requests

res = requests.get(
    "https://console.intuizi.com/api/v2/analyses/reference/ctv/device-oses",
    headers={"Authorization": "Bearer <YOUR_TOKEN>", "Accept": "application/json"},
    params={"search": "tizen"},
)
page = res.json()["data"]

const res = await fetch(
  "https://console.intuizi.com/api/v2/analyses/reference/ctv/device-oses?search=tizen",
  { headers: { Authorization: "Bearer <YOUR_TOKEN>", Accept: "application/json" } }
);
const page = (await res.json()).data;

Response

{
  "status": "success",
  "code": 200,
  "message": "Resources fetched successfully.",
  "data": {
    "items": [
      { "value": "Example", "text": "Example" }
    ],
    "pagination": { "current_page": 1, "per_page": 500, "total": 1, "last_page": 1 }
  }
}

Get Connection Types

GET /api/v2/analyses/reference/ctv/connection-types

CTV connection type names, paginated and searchable. Each item is a { value, text } pair - use the value in the matching audience create field.

Query parameters

Field	Type	Required	Description
`page`	integer	No	Page to fetch. Defaults to 1.
`per_page`	integer	No	Items per page. Defaults to 500, capped at 500.
`search`	string	No	Free-text search on the item name (case-insensitive contains).

curl "https://console.intuizi.com/api/v2/analyses/reference/ctv/connection-types?search=wifi" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"

import requests

res = requests.get(
    "https://console.intuizi.com/api/v2/analyses/reference/ctv/connection-types",
    headers={"Authorization": "Bearer <YOUR_TOKEN>", "Accept": "application/json"},
    params={"search": "wifi"},
)
page = res.json()["data"]

const res = await fetch(
  "https://console.intuizi.com/api/v2/analyses/reference/ctv/connection-types?search=wifi",
  { headers: { Authorization: "Bearer <YOUR_TOKEN>", Accept: "application/json" } }
);
const page = (await res.json()).data;

Response

{
  "status": "success",
  "code": 200,
  "message": "Resources fetched successfully.",
  "data": {
    "items": [
      { "value": "Example", "text": "Example" }
    ],
    "pagination": { "current_page": 1, "per_page": 500, "total": 1, "last_page": 1 }
  }
}

Get ISPs

GET /api/v2/analyses/reference/ctv/isps

CTV ISP names, paginated and searchable. Each item is a { value, text } pair - use the value in the matching audience create field.

Query parameters

Field	Type	Required	Description
`page`	integer	No	Page to fetch. Defaults to 1.
`per_page`	integer	No	Items per page. Defaults to 500, capped at 500.
`search`	string	No	Free-text search on the item name (case-insensitive contains).

curl "https://console.intuizi.com/api/v2/analyses/reference/ctv/isps?search=comcast" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"

import requests

res = requests.get(
    "https://console.intuizi.com/api/v2/analyses/reference/ctv/isps",
    headers={"Authorization": "Bearer <YOUR_TOKEN>", "Accept": "application/json"},
    params={"search": "comcast"},
)
page = res.json()["data"]

const res = await fetch(
  "https://console.intuizi.com/api/v2/analyses/reference/ctv/isps?search=comcast",
  { headers: { Authorization: "Bearer <YOUR_TOKEN>", Accept: "application/json" } }
);
const page = (await res.json()).data;

Response

{
  "status": "success",
  "code": 200,
  "message": "Resources fetched successfully.",
  "data": {
    "items": [
      { "value": "Example", "text": "Example" }
    ],
    "pagination": { "current_page": 1, "per_page": 500, "total": 1, "last_page": 1 }
  }
}

Get Series

GET /api/v2/analyses/reference/ctv/series

CTV series names, paginated and searchable. Each item is a { value, text } pair - use the value in the matching audience create field.

Query parameters

Field	Type	Required	Description
`page`	integer	No	Page to fetch. Defaults to 1.
`per_page`	integer	No	Items per page. Defaults to 500, capped at 500.
`search`	string	No	Free-text search on the item name (case-insensitive contains).

curl "https://console.intuizi.com/api/v2/analyses/reference/ctv/series?search=drama" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"

import requests

res = requests.get(
    "https://console.intuizi.com/api/v2/analyses/reference/ctv/series",
    headers={"Authorization": "Bearer <YOUR_TOKEN>", "Accept": "application/json"},
    params={"search": "drama"},
)
page = res.json()["data"]

const res = await fetch(
  "https://console.intuizi.com/api/v2/analyses/reference/ctv/series?search=drama",
  { headers: { Authorization: "Bearer <YOUR_TOKEN>", Accept: "application/json" } }
);
const page = (await res.json()).data;

Response

{
  "status": "success",
  "code": 200,
  "message": "Resources fetched successfully.",
  "data": {
    "items": [
      { "value": "Example", "text": "Example" }
    ],
    "pagination": { "current_page": 1, "per_page": 500, "total": 1, "last_page": 1 }
  }
}

Web Domain Visitors Apps