Step 1: Understanding Namespaces

GWI organizes its research into namespaces, such as “Core” or “Sports.” Each namespace represents a distinct study or area of focus. For example, the gwi-sports namespace contains all questions and datapoints from GWI Sports, our sports focused dataset. To query a question in GWI-sports you would use the relevant namespace prefix i.e.gwi-sports.q2 ,The gwi-sports represents the namespace and the q2 represents that it is question 2 in that survey.

The one exception to the namespace rule is Core, GWI’s largest survey. In this case no namespace is needed. So any question without the namespace prefix would belong to the Core survey, for example q10 represents question 10 in Core.

Key ways of filtering the data such as Locations, Waves (time periods) and Splitters are defined on the namespace level, so to find out which filters can be used with selected question, we need to use the question’s namespace code

To locate and retrieve details for a specific question, use the Question Filter Endpoint:

curl -X POST "https://api.globalwebindex.com/v3/questions/filter" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{ "questions": [{"question": "q42011", "namespace_code": "core"}], "include": {"datapoints": true} }'

Response

{
	"questions": [
		{
			"question": "q42011",
			"name": "Named Social Media / Messaging Services Used",
			"namespace_code": "core",
			"description": "How often do you visit or use these services?",
			"message": "Question added in Q4 2020. Asked in all GWI Core markets.\n\nThe figures represent all internet users aged 16-64.  From Q1 2024 the figures in Canada, Hong Kong, Israel, Japan, Singapore, UK, USA  represent internet users aged 16+.\nThis question replaced earlier versions (q46x1, q46x2, r52alls). These older questions can now be found in the Legacy Data section.\n\nAdded in Q1 2021: Triller (USA Only), Xiaohongshu (China Only); Added in Q2 2021: ShareChat; Added in Q3 2021: MX Takatak (India Only), Clubhouse, Chingari (India Only), Moj (India Only), Kuaishou (Select Markets Only). Added in Q4 2021: Yalla (Egypt, Saudi Arabia and UAE Only). 'Kuaishou' is asked as Kwai in Brazil, Egypt and Russia and as 'Snack Video' in Indonesia. Added in Q1 2022: Kumu (Philippines Only) Added in Q3 2022: Koo (India Only) Added in Q4 2022: BeReal (Select Markets Only). Added in Q1 2023: WeAre8 (UK Only). Added in Q2 2023: Dewu (China Only), Mastodon. Added in Q4 2023: Threads (Select Markets Only). Since Q2 2024 \"Threads\" is asked in all markets. Added in Q2 2024: Lemon8 (Select Markets Only). Added in Q3 2024: BlueSky, Quora\n\nTikTok is displayed as Douyin in China. WeChat is displayed as Weixin in China. In Q1 2023, TikTok display was changed to \"TikTok / Douyin\" in Hong Kong.\nIn Q3 2023 Croatia was added to Viadeo (Select Markets Only)\n\n\nThe question is asked in Ghana since Q1 2021. This question is asked in Czech Republic since Q1 2022. \nThe question is not available for Morocco in Q1 2023.\nTwitter was updated to X in Q4 2023.",
			"datapoints": [
				{
					"datapoint": "q42011_19",
					"name": "5channel (Japan Only)",
					"order": 341
				},
				{
					"datapoint": "q42011_55",
					"name": "Apple iMessage",
					"order": 342
				},
	       ...
				{
                    "datapoint": "q42011_3",
                    "name": "Facebook",
                    "order": 354
                },
		   ...
		}
	]
}