Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api.globalwebindex.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

On this page

​
Applying an Audience to a Chart

Audiences help you define exactly who you want to understand. Whether you’re starting from scratch or tweaking a ready-made GWI persona, it’s your space to build the audience that fits your goals. For more detail on creating an audience via our API, see Create audiences. You can apply audiences to focus your analysis on the people you want to understand. If you don’t add an audience, your analysis will be calculated for the default population of the dataset. E.g. for GWI Core, the default population is “All Internet Users - age 16-64” (or 16+ in some markets). There are two ways to apply an audience: you can apply one or more audiences while keeping the same overall base, or apply an audience as the base. If no audience is provided, the chart is calculated using the default population of the dataset. The example below shows an audience applied to the chart. The results show how that specific audience compares across working status, but the base of the analysis remains all internet users.
Image
Image from the GWI platform showcasing an applied audience to a chart.

​
How it works

To apply one or more audience(s) to your chart:
  1. Identify the audience(s) you want to use (pre-defined or dynamically constructed).
  2. Include the audience identifier in your chart request payload.
  3. The API calculates all metrics to show how your selected audience(s) performs across the chart attributes.
If you want to compare two or more customer profiles (e.g., Gen Z vs Millennials), you can apply multiple audiences (where supported) or generate separate chart requests per audience. You can use the cURL below to replicate the chart example and adapt it to your use case. 
curl -X POST "https://api.globalwebindex.com/v1/charts" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d @chart_add.json

​
Applying an Audience as a Base to a Chart

The base refers to everyone that’s included in your analysis. Think of it as your reference point. By default, the base includes everyone that’s represented by the data set you’ve selected (e.g. all internet users aged 16+ for GWI Core), but sometimes you may want to apply a more specific filter to your analysis and change your reference point entirely, so all results are recalculated using a specific audience as a filter. When an audience is applied as a base, all percentages and metrics are calculated using that audience as the denominator. The example below shows an audience applied as a base. The results show how that audience compares across working status, with the analysis calculated using that audience as the base population.
Image
Image from the GWI platform showcasing an applied audience as a base to a chart.

​
How it works

  1. Create or retrieve the audience you want to use.
  2. Include the audience identifier in your chart creation request as the base audience.
  3. The API calculates all results relative to that audience population.
This differs from applying an audience to a chart. Respondents that do not match with the set base audience are filtered out.

You can use the cURL below to replicate the chart example and adapt it to your use case. 
curl -X POST "https://api.globalwebindex.com/v1/charts" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d @chart_base.json

​
Applying an Audience to a Crosstab

You can apply audiences to focus your analysis on the people you want to understand. If you don’t add an audience, your analysis will be calculated for the default population of the dataset. E.g. for GWI Core, the default population is “All Internet Users - age 16-64” (or 16+ in some markets). There are two ways to apply an audience: you can apply one or more audiences while keeping the same overall base, or apply an audience as the base. For more information on how crosstabs work on our platform, you can find it on our help center article. The example below shows an audience applied to the crosstab as a column. The results show how that specific audience compares across working status, but the base of the analysis remains all internet users.
Image
Image from the GWI platform showcasing an applied audience to a crosstab as a column.

​
How it works

  1. Identify the audience(s) you want to use (pre-defined or dynamically constructed).
  2. Include the audience(s) either as rows or columns in your code.
  3. The API calculates all row and column metrics using only respondents in that audience.
This ensures that both dimensions of the crosstab are evaluated within the selected segment. You can use the cURL below to replicate the chart example and adapt it to your use case. 
curl -X POST "https://api.globalwebindex.com/v2/saved/crosstabs" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d @xb_add.json

​
Applying an Audience as a Base to a Crosstab

The base refers to everyone that’s included in your analysis. Think of it as your reference point. By default, the base includes everyone that’s represented by the data set you’ve selected (e.g. all internet users aged 16+ for GWI Core), but sometimes you may want to apply a more specific filter to your analysis and change your reference point entirely, so all results are recalculated using a specific audience as a filter. When an audience is applied as a base, it defines the denominator for all row and column calculations in the crosstab. The example below shows an audience applied as a base. The results show how that audience compares across working status, with the analysis calculated using that audience as the base population.
Image
Image from the GWI platform showcasing an applied audience to a crosstab as a base.

​
How it works

  1. Create or retrieve the audience you want to use.
  2. Include the audience identifier in your crosstab request as the base audience.
  3. The API calculates all cross-tabulated metrics relative to that audience population.
Unlike applying an audience as a filter for comparison, using an audience as a base changes the underlying population for the entire crosstab. You can use the cURL below to replicate the chart example and adapt it to your use case. 
curl -X POST "https://api.globalwebindex.com/v2/saved/crosstabs" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d @xb_base.json

{
  "name": "API Chart (add audience)",
  "audiences": [
    {
      "id": "b848dd5f-52af-433c-a905-1222070b121a",
      "name": "GWI API audience",
      "expression": {
        "and": [
          {
            "question": "q3new",
            "datapoints": [
              "q3new_3"
            ]
          }
        ]
      }
    }
  ],
  "dataset_codes": [
    "ds-core"
  ],
  "location_codes": [
    "s2_1"
  ],
  "wave_codes": [
    "q1_2025"
  ],
  "attributes": [
    {
      "question_code": "q42011a",
      "datapoint_code": "3",
      "namespace_code": "core",
      "suffix_code": "1"
    },
    {
      "question_code": "q42011a",
      "datapoint_code": "3",
      "namespace_code": "core",
      "suffix_code": "2"
    }
  ],
  "view_type": 0,
  "sort_type": 0,
  "group_type": 1,
  "segments": [],
  "segmented_base": false,
  "metrics": [
    "datapoint_percentage",
    "positive_size",
    "audience_index",
    "positive_sample",
    "audience_percentage"
  ]
}