Create Audiences

Audiences are custom segments of respondents that you can create to focus your analysis on specific groups of people. These segments help you unlock insights that are most relevant to your goals by isolating key behaviors, demographics, or preferences within GWI’s rich data.

With GWI, you can build Audiences that reflect real-world segments of the populace, ensuring that your data-driven decisions are accurate and actionable. Whether you’re targeting Gen Z gamers, frequent social media users, or parents who stream content daily, Audiences allow you to explore behaviors and trends tailored to your exact needs.

By defining an Audience, you can:

1. Focus your insights on the groups that matter most to your business.
2. Compare segments side-by-side to uncover differences and affinities.
3. Create tailored strategies for marketing, product development, and more.

Audiences can be built using a combination of attributes, behaviors and filters, such as location, frequency of use, or demographics. Once created, they can be applied across other tools like Charts, Crosstabs, Dashboards, or API queries to streamline analysis and deliver insights at scale.

Let’s create an Audience of people aged between 25-34 who are based in the UK and who use Instagram, Facebook or Twitter at least once a day or like gaming, and have no children.

Create Audience

• Use AND, OR, NOT in the Audience request:
  • live in UK (s2_44)
  • 25-34 years old (q4_3)
  • use Instagram/Facebook/Twitter daily (q42011a_3/q42011a_14/q42011a_25) or like gaming (q3181c_23)
  • do not have children living with them (NOT q22010_2)

Create Audience

curl -X POST "https://api.globalwebindex.com/v2/saved/audiences" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d @req.json

Manage Audience by ID

You can simply use a GET request with given <AUDIENCE_ID> to retrieve the Audience. To update the Audience, you can use either PATCH or PUT method. Both the request body and the response are equivalent to when you create an Audience. To remove the Audience, you can use DELETE method.

Retrieve Audience

curl -X GET "https://api.globalwebindex.com/v2/saved/audiences/<AUDIENCE_ID>" \
  -H "Authorization: Bearer YOUR_API_KEY"

req.json

{
  "name": "test_audience",
  "expression": {
    "and": [
      {
        "question": "s2",
        "datapoints": [
          "s2_44"
        ]
      },
      {
        "question": "q4",
        "datapoints": [
          "q4_3"
        ]
      },
      {
        "or": [
          {
            "question": "q42011a",
            "datapoints": [
              "q42011a_25",
              "q42011a_14",
              "q42011a_3"
            ],
            "suffixes": [
              2
            ]
          },
          {
            "question": "q3181c",
            "datapoints": [
              "q3181c_23"
            ]
          }
        ]
      },
      {
        "question": "q22010",
        "datapoints": [
          "q22010_2"
        ],
        "not": true
      }
    ]
  }
}

Create Response

{
  "id": "<AUDIENCE_ID>",
  "v1_id": 123456789,
  "folder_id": null,
  "description": "",
  "name": "test_audience",
  "expression": {
    "and": [
      {
        "datapoints": [
          "s2_44"
        ],
        "question": "s2"
      },
      {
        "datapoints": [
          "q4_3"
        ],
        "question": "q4"
      },
      {
        "or": [
          {
            "datapoints": [
              "q42011a_25",
              "q42011a_14",
              "q42011a_3"
            ],
            "question": "q42011a",
            "suffixes": [
              2
            ]
          },
          {
            "datapoints": [
              "q3181c_23"
            ],
            "question": "q3181c"
          }
        ]
      },
      {
        "datapoints": [
          "q22010_2"
        ],
        "question": "q22010",
        "not": true
      }
    ]
  },
  "datasets": [
    "ds-core"
  ],
  "flags": [
    "authored"
  ],
  "position": 0,
  "shared": false,
  "sharings": {
    "private": {
      "organisation_ids": null,
      "users": null,
      "sharer": {
        "email": "[e-mail]",
        "id": 654321
      }
    }
  },
  "user_id": 654321,
  "permissions": {
    "audience_overall": "accessible"
  },
  "created_at": "2025-01-15T10:07:54.833633391Z",
  "updated_at": "2025-01-15T10:07:54.833633391Z"
}

More detail on how audiences work in our platform is available in our help center.