v2 List Audiences

curl --request GET \
  --url https://api.globalwebindex.com/v2/saved/audiences \
  --header 'Authorization: <api-key>'

{
  "meta": null,
  "data": [
    {
      "id": "8f568af7-a225-40fd-992f-839d8f0ed499",
      "name": "Male with credit card and short-term load",
      "expression": {
        "and": [
          {
            "question": "q2",
            "datapoints": [
              "q2_1"
            ]
          },
          {
            "question": "gwi-ext.q1014a",
            "datapoints": [
              "q1014a",
              "q1014b"
            ],
            "suffixes": [
              "1"
            ]
          }
        ]
      },
      "flags": [
        "authored",
        "curated",
        "isP2"
      ],
      "folder_id": "b140035b-3adc-43bf-a39d-8e8005c8af2a",
      "position": 128.1,
      "permissions": {
        "audience_overall": "accessible"
      },
      "datasets": [
        "ds-core",
        "ds-96c906f1"
      ]
    }
  ]
}

GET

saved

audiences

v2 List Audiences

curl --request GET \
  --url https://api.globalwebindex.com/v2/saved/audiences \
  --header 'Authorization: <api-key>'

{
  "meta": null,
  "data": [
    {
      "id": "8f568af7-a225-40fd-992f-839d8f0ed499",
      "name": "Male with credit card and short-term load",
      "expression": {
        "and": [
          {
            "question": "q2",
            "datapoints": [
              "q2_1"
            ]
          },
          {
            "question": "gwi-ext.q1014a",
            "datapoints": [
              "q1014a",
              "q1014b"
            ],
            "suffixes": [
              "1"
            ]
          }
        ]
      },
      "flags": [
        "authored",
        "curated",
        "isP2"
      ],
      "folder_id": "b140035b-3adc-43bf-a39d-8e8005c8af2a",
      "position": 128.1,
      "permissions": {
        "audience_overall": "accessible"
      },
      "datasets": [
        "ds-core",
        "ds-96c906f1"
      ]
    }
  ]
}

Authorizations

Authorization

string

header

required

Query Parameters

folder_id

string

List audiences from given folder only

flags

string[]

List audiences with a given flag(s) only

Response

Collection of all available audiences.

data

object[]

List of audiences

Show child attributes

data.id

string

required

Unique ID of saved audience

data.v1_id

integer

required

v1 ID of an audience if applicable or null

data.name

string

required

Human readable name

data.expression

Expression · object

required

Flexible expression of audience scope.

Show child attributes

data.expression.and

array

List of sub-expressions to apply intersection of their scopes.

data.expression.or

array

List of sub-expressions to apply union of their scopes.

data.expression.not

boolean

To use negation of the expression.

data.expression.question

string

Question code to define datapoint scope.

Example:

"q2"

data.expression.datapoints

string[]

Datapoint codes to limit scopes of interest.

Example:

["q2_1", "q2_2"]

data.expression.suffixes

string[]

Suffixes to extend datapoint codes for more detailed responses. Array can be empty.

Example:

["1", "2", "3"]

data.expression.min_count

integer

Minimal count of positive datapoints in one response.

Example:

1

Example:

{
  "and": [
    {
      "question": "q2",
      "datapoints": ["q2_1", "q2_2"],
      "min_count": 1,
      "not": false
    },
    {
      "question": "q6",
      "datapoints": ["q6_2"],
      "min_count": 1,
      "suffixes": ["1", "2", "3"],
      "not": false
    }
  ]
}

data.created_at

string

required

when item was created

data.updated_at

string

required

when item was updated

data.folder_id

string

required

null/nil uuid or folder uuid

data.position

number

required

items are sorted by numeric position

data.permissions

object

required

Show child attributes

data.permissions.permissions

object

required

Show child attributes

data.permissions.permissions.audience_overall

string

required

Strings accessible or containsUnknownData describe overall permission of a user to an audience.

data.permissions.permissions.code

integer

required

This field is kept for consistency with query-es route permissions response. It is not used in saved-data at all.

data.permissions.permissions.error

string

Error describes what kind of error occured if there was one. This field explains better errorType field.

data.permissions.permissions.errorType

string

Type of the error

Example:

{
  "meta": { "limit": 5, "offset": 15, "count": 100 },
  "data": ["..."]
}

data.datasets

string[]

required

dataset codes

data.flags

enum<string>[]

additional flags about audience

Flags:

authored: User owns the entity
curated: GWI shared the entity to others
isP2: item created by Platform2

Available options:

authored,

curated,

isP2

v2 Filter Audiences v2 Replace Audience

⌘I

Getting started

Use Cases

Transition from V1 to V2 API

Platform API

v2 List Audiences

Authorizations

Query Parameters

Response