Web Domain Visitors

Reference catalogs for the WebDomain 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).

Most reads on this page are paginated: they accept page, per_page (default 500, capped at 500) and search, and return data.items plus a data.pagination block. The two IAB catalog reads (categories and subcategories) are the exception: they return a flat list directly under data and are not paginated.

Get IAB Categories

GET /api/v2/analyses/reference/web/iab-categories

All IAB primary categories. Flat list of { value, text, id } (not paginated). Use the returned id as a WebDomain dataset’s iab_category_codes, and the value (the IAB code) as a category_codes filter on Get Domains.

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/web/iab-categories" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"

import requests

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

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

Response

{
  "status": "success",
  "code": 200,
  "message": "Resources fetched successfully.",
  "data": [
    { "value": "IAB2", "text": "IAB2 - Automotive", "id": 2 }
  ]
}

Get IAB Subcategories

GET /api/v2/analyses/reference/web/iab-subcategories

IAB tier-2 subcategories. Flat list of { value, text, id, iab_category_id } (not paginated). Pass category_ids to scope to specific parent categories.

Query parameters

Field	Type	Required	Description
`category_ids`	array	No	Parent IAB category ids (or codes) to filter by. Use one kind per call: the first value decides whether every value is read as an id or as a code, and values of the other kind are dropped without an error.
`search`	string	No	Optional free-text filter on the item label (case-insensitive contains).

curl "https://console.intuizi.com/api/v2/analyses/reference/web/iab-subcategories?category_ids[]=2" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"

import requests

res = requests.get(
    "https://console.intuizi.com/api/v2/analyses/reference/web/iab-subcategories",
    headers={"Authorization": "Bearer <YOUR_TOKEN>", "Accept": "application/json"},
    params={"category_ids[]": 2},
)
subcategories = res.json()["data"]

const res = await fetch(
  "https://console.intuizi.com/api/v2/analyses/reference/web/iab-subcategories?category_ids[]=2",
  { headers: { Authorization: "Bearer <YOUR_TOKEN>", Accept: "application/json" } }
);
const subcategories = (await res.json()).data;

$res = Http::withToken('<YOUR_TOKEN>')->acceptJson()
    ->get('https://console.intuizi.com/api/v2/analyses/reference/web/iab-subcategories', ['category_ids' => [2]]);
$subcategories = $res->json('data');

Response

{
  "status": "success",
  "code": 200,
  "message": "Resources fetched successfully.",
  "data": [
    { "value": "IAB2-1", "text": "IAB2-1 - Auto Parts", "id": 21, "iab_category_id": 2 }
  ]
}

Get Domains

GET /api/v2/analyses/reference/web/domains

Web domains, optionally filtered by IAB category or subcategory codes. Each item carries value, text and the domain’s iab_code.

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 domain search.
`category_codes`	string[]	No	IAB category codes to filter by (e.g. `["IAB2"]`).
`subcategory_codes`	string[]	No	IAB subcategory codes to filter by (e.g. `["IAB2-1"]`). Takes precedence over `category_codes`.

curl "https://console.intuizi.com/api/v2/analyses/reference/web/domains?search=cars&category_codes[]=IAB2" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"

import requests

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

const res = await fetch(
  "https://console.intuizi.com/api/v2/analyses/reference/web/domains?search=cars&category_codes[]=IAB2",
  { headers: { Authorization: "Bearer <YOUR_TOKEN>", Accept: "application/json" } }
);
const page = (await res.json()).data;

$res = Http::withToken('<YOUR_TOKEN>')->acceptJson()
    ->get('https://console.intuizi.com/api/v2/analyses/reference/web/domains', [
        'search' => 'cars', 'category_codes' => ['IAB2'],
    ]);
$page = $res->json('data');

Response

{
  "status": "success",
  "code": 200,
  "message": "Resources fetched successfully.",
  "data": {
    "items": [
      { "value": "cars.example.com", "text": "cars.example.com", "iab_code": "IAB2-1" }
    ],
    "pagination": { "current_page": 1, "per_page": 500, "total": 1, "last_page": 1 }
  }
}

Get Referrer Domains

GET /api/v2/analyses/reference/web/ref-domains

Web referrer domains. Each item is a { value, text } pair.

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.

curl "https://console.intuizi.com/api/v2/analyses/reference/web/ref-domains?search=autotrader" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"

import requests

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

const res = await fetch(
  "https://console.intuizi.com/api/v2/analyses/reference/web/ref-domains?search=autotrader",
  { 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": "autotrader.example.com", "text": "autotrader.example.com" }
    ],
    "pagination": { "current_page": 1, "per_page": 500, "total": 1, "last_page": 1 }
  }
}

Get Browsers

GET /api/v2/analyses/reference/web/browsers

Web browsers. Each item is a { value, text } pair (value is the raw browser name; text falls back to its description when set).

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.

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

import requests

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

const res = await fetch(
  "https://console.intuizi.com/api/v2/analyses/reference/web/browsers?search=Safari",
  { 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": "Safari", "text": "Safari" }
    ],
    "pagination": { "current_page": 1, "per_page": 500, "total": 1, "last_page": 1 }
  }
}

Get Device Types

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

Web device types. Same { value, text } shape and pagination as web browsers.

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.

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

import requests

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

const res = await fetch(
  "https://console.intuizi.com/api/v2/analyses/reference/web/device-types?search=mobile",
  { 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": "Mobile", "text": "Mobile" }
    ],
    "pagination": { "current_page": 1, "per_page": 500, "total": 1, "last_page": 1 }
  }
}

Get Device Makes

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

Web device makes. Same { value, text } shape and pagination as web device types.

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.

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

import requests

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

const res = await fetch(
  "https://console.intuizi.com/api/v2/analyses/reference/web/device-makes?search=Apple",
  { 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": "Apple", "text": "Apple" }
    ],
    "pagination": { "current_page": 1, "per_page": 500, "total": 1, "last_page": 1 }
  }
}

Get Device OSes

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

Web device operating systems. Same { value, text } shape and pagination as web device makes.

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.

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

import requests

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

const res = await fetch(
  "https://console.intuizi.com/api/v2/analyses/reference/web/device-oses?search=iOS",
  { 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": "iOS", "text": "iOS" }
    ],
    "pagination": { "current_page": 1, "per_page": 500, "total": 1, "last_page": 1 }
  }
}

Connected TV