Catalogs

Read the ids every other command needs. Conventions apply to every command here.

intuizi reference <group> <catalog>

Every catalog read is a GET with no side effects, so they are safe to explore. Each takes --search, a case-insensitive contains match, except profile-attributes recency-limits, which takes no flags of its own. Most catalogs match it on the label. The demographics genders, marital-statuses, and incomes match the value code instead (--search F, not female), apps bundle-ids matches the app name, and poi locations matches the name or the address. Some catalogs match a hidden field as well as the label, so a row can match a term its label does not show: the web and ctv device types, makes, and OSes, web browsers, the ctv connection types, ISPs, and series, and the profile-attributes keys and values also match the underlying name, key, or value. Paged catalogs also take --page and --per-page, and return one page per call.

--quiet prints each row’s value or id, one per line, which is what composes into another command:

intuizi reference poi brands --search coffee --quiet

For web iab-categories that is the IAB code, which feeds web domains --category-codes. audiences create --category sends the number in the id column instead, so pass it that number, the IAB code, or a category name.

--quiet is refused on profile-attributes recency-limits: its one row is a pair of dates with no id or value. Read it as a table or with --json.

Groups

Each group is a command under intuizi reference, and each catalog is a command under its group, named after its endpoint’s path. Two names differ from the API: the transactions group reads the API’s affinity-transactions catalogs, and reference cohorts list reads cohorts/get-cohorts. A dataset type with no group of its own is built from the common catalogs alone.

Each catalog below links to its endpoint, which lists the values it returns. A catalog’s flags are its endpoint’s query parameters in kebab-case: datasetType is --dataset-type, partner_id is --partner-id. List flags repeat (--states CA --states NY), and the integer id flags also accept commas (--segments 1,2). web iab-subcategories --category-ids, which also takes codes, does not, so repeat it. A required flag is checked before anything is sent. intuizi reference <group> <catalog> --help prints the same set.

Common

Catalogs shared across every dataset type. See Common.

datastreams and datastream-visualizations are different catalogs. datastreams lists a partner’s delivery outputs, which an activation’s --datastream enables. datastream-visualizations lists the charts an audience can draw while it builds, for the datastreams array of an audience --file body. Its dataset_types column says which dataset types each stream applies to.

POI

The POI taxonomy an audience picks from. See POI. Your own POI data is managed with the POI commands instead.

locations takes no --states or --cities: the API’s state and city narrowing has no flag.

Apps

App categories, tags, OSes, bundle ids, and taxonomies. See Apps.

CTV

Connected TV vendors, content, channels, and devices. See Connected TV.

Web

IAB categories, web domains, browsers, and devices. See Web Domain Visitors.

Transactions

Affinity purchase categories, brands, and demographics, read from the API’s affinity-transactions catalogs. See Transactions.

Demographics

Gender, age, marital status, and income dictionaries. See Demographics.

Profile attributes

Attribute categories, keys, values, and the window a dataset’s dates must fall inside. See Profile Attributes.

Deidentified

The signal fields a delivery can carry. See Deidentified.

Cohorts

Your company’s completed cohorts, read from get-cohorts. See Cohorts. To import or manage cohorts, see the Cohorts commands.

Cascading reads

Several catalogs cascade: a child read takes values from the level above to narrow its list.

Geography requires the parent. states needs --countries, dmas needs --countries, cities needs --states, and zipcodes needs --cities. Their other flags only narrow the list:

intuizi reference common states --countries USA
intuizi reference common cities --states CA
intuizi reference common zipcodes --cities "Los Angeles" --states CA

In every other cascade the parent is optional, and leaving it out returns the catalog unfiltered:

• poi: segments, then categories (--segments), then brands (--categories), then locations (--brands).
• transactions: categories, then subcategories (--categories), then brands (--categories, --subcategories).
• profile-attributes: categories, then keys (--category-ids), then values (--category-ids, --key).
• web: iab-categories, then iab-subcategories (--category-ids). domains narrows by either level (--category-codes, --subcategory-codes).

intuizi reference poi categories --segments <segment_id>
intuizi reference poi brands --categories <category_id>

Envelope shapes

Flat reads return an array directly under data. Paged reads return data.items alongside a pagination block. A script consuming --json has to handle both, which is what --quiet avoids. A catalog is paged when it takes --page, as the tables above show. Common and the pages under Dataset Types show each read’s shape.