Discovery

Return masked sample rows matching criteria

Returns up to 25 masked sample rows matching the criteria. PII attributes are masked or omitted. Requires 'discovery' scope. Provide exactly one of: filters, filter_groups, segment_id, audience_id, or segment_ids + set_logic (same input shapes as /v1/discovery/count). Sending more than one returns 400 AMBIGUOUS_INPUT; sending none returns 400 NO_INPUT_SPECIFIED. If you pass a segment, audience, or filter groups, full group/combinator structure is preserved — each segment's own AND/OR groups are evaluated intact, multiple composed segments are combined by set_logic, and an audience's excluded segments are always subtracted (AND NOT), regardless of set_logic.

post/v1/discovery/lookup

Request

  • Base URL: https://api.infiniteaudience.ai
  • URL: https://api.infiniteaudience.ai/v1/discovery/lookup
  • Auth: HTTP bearer

Request body

segment_idstring

ID of a saved segment to sample from.

audience_idstring

ID of a saved audience to sample from.

segment_idsstring[]

IDs of multiple segments to combine (requires set_logic).

set_logic'union' | 'intersection'

How to combine segment_ids: union = match ANY segment (OR); intersection = match EVERY segment (AND).

excluded_segment_idsstring[]

Ad-hoc "A minus B" preview — segments to subtract from the segment_ids composition, without persisting an audience. Only meaningful alongside segment_ids; do not send set_logic: 'exclusion' (invalid).

limitinteger
fieldsstring[]

Optional non-PII audience fields to preview. Defaults to a small demographic selection. Discover field names with GET /v1/catalog/fields.

Response

Sample rows.

rowsobject[] required

Up to limit sample rows containing only the selected non-PII audience fields.

total_matchedinteger required

Total records matching the criteria (may exceed rows.length, which is capped at limit).

available_fieldsstring[] required

Field names present on the returned rows (after PII masking/omission).

Changes

No recorded changes to this operation across all 1 revision of this API.