# Dataset Types


Read-only catalogs, one group per dataset type, that back the audience builder.
Read these first to collect the ids and values the
[Audiences]({{< relref "/api/v2/audiences" >}}) create body expects: IAB ids,
CTV names, app bundle ids, cohort ids, POI ids, and so on. Catalogs shared
across every dataset type - geography, languages, signal providers, endpoint
connections - live in [Common]({{< relref "/api/v2/common" >}}).

Every reference read is authenticated and JSON-only. Send `Authorization: Bearer
<token>` and `Accept: application/json` on every call. All reference reads use the
read rate bucket (120 requests/min per caller).

Two response envelopes are used:

- **Flat list reads** return an array directly under `data`.
- **Paginated reads** return `data.items` plus a `data.pagination` block
  (`current_page`, `per_page`, `total`, `last_page`). Paginated reads accept
  `page`, `per_page` and `search` query parameters. `per_page` defaults to 500
  and is capped at 500 on the Common, Web and CTV reads; the four paginated
  Apps reads default to 250 and are **uncapped**.

Every list read - flat or paginated - accepts an optional `search` query
parameter: a case-insensitive contains-match on the item's display label.

- [Web Domain Visitors](/api/v2/reference/web) - IAB categories and subcategories, web domains, referrer domains, browsers, device types, makes and OSes.
- [Connected TV](/api/v2/reference/ctv) - CTV vendors, content types, content genres, channel names, device types, makes and OSes, connection types, ISPs and series.
- [Apps](/api/v2/reference/apps) - app categories, tags, operating systems, bundle ids and taxonomies.
- [Cohorts](/api/v2/reference/cohorts) - your company's completed cohorts.
- [POI](/api/v2/reference/poi) - POI segments, categories, brands and locations to pick from while building an audience (segments -> categories -> brands -> locations cascade). Managing the POI data itself is the separate [My POI Data]({{< relref "/api/v2/poi" >}}) surface.
- [Transactions](/api/v2/reference/affinity-transactions) - affinity purchase categories, sub-categories and brands (categories -> subcategories -> brands cascade) plus the income, age, gender and ethnicity dictionaries: the values an `AffinityTransactions` dataset and a [cross purchase analysis](/api/v2/audiences#crosspurchase) are scoped to.
- [Demographics](/api/v2/reference/demographics) - the gender, age range, marital status and income range dictionaries a `Demographics` dataset is scoped to.
- [Deidentified](/api/v2/reference/deidentified) - the signal fields, in their six groups, a `Deidentified` dataset can carry into its delivery.
- [Profile Attributes](/api/v2/reference/profile-attributes) - the attribute categories, keys and values a `ProfileAttributes` dataset is scoped to (categories -> keys -> values cascade), plus the delivered quarter window its date range is bounded to.
- Origin has no catalog of its own: an `Origin` dataset is scoped with the [Common](/api/v2/common) geography reads - countries (with `?datasetType=Origin` for the covered set), states, cities, DMAs and ZIP codes. Its fields are on [Create Audience](/api/v2/audiences#post-apiv2analysesaudiencescreate).

Company-scoped reads (cohorts, endpoint connections, your company's partners)
return your company's records; credentials and partner secrets are never
exposed.