discovery

Get brand cohorts (v2)

Read the head-to-head ring for a set of brands within one cohort (a decision factor, audience, or AI engine) over a campaign's results window: their order and pairwise records.

get/api/v1/discovery/brand-cohorts-v2/{id}

Request

  • Base URL: https://point11.ai
  • URL: https://point11.ai/api/v1/discovery/brand-cohorts-v2/{id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://auth.point11.ai/oauth2/authorize, token URL https://auth.point11.ai/oauth2/token)

Path parameters

idstring uuid required

Discovery campaign id.

Query parameters

dateRangestring nullable

Result window: all, a preset id, or yyyy-MM-dd..yyyy-MM-dd. Omit for the campaign's default window.

segmentsstring[]

Narrows the read to these segments, ANDed: one axis:id per axis (any number of distinct customer: entries), in canonical axis order. Empty reads the whole dispatch.

cohortDimension'decision-factors' | 'audiences' | 'engines' required

The cohort's dimension; give it with cohortValue.

cohortValuestring required

The cohort member's id on cohortDimension.

memberKeysstring[] required

The ring's brands, 1 to 16 unique normalized keys.

Headers

Point11-Organizationstring uuid

Organization to act in. Required for OAuth bearers; an API key acts in the organization that owns it.

Response

Success.

Changes

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