curl -X POST "https://api.globalwebindex.com/v2/query/stats" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -d '{
            "question": "q42011"
        }'

{
  "meta": {
    "type": "DATAPOINTS",
    "question": "q42011",
    "splitter": ""
  },
   "data": [
    {
      "datapoint": "q42011_1",
      "waves": [
        "q1_2021",
        "q1_2022",
        "q1_2023",
        "q1_2024",
        "q2_2021",
        "q2_2022",
        "q2_2023",
        "q2_2024",
        "q3_2021",
        "q3_2022",
        "q3_2023",
        "q4_2020",
        "q4_2021",
        "q4_2022",
        "q4_2023"
      ],
      "metrics": {
        "positive_sample": 143734,
        "positive_size": 136246170,
        "audience_sample": 3390266,
        "audience_size": 2777556090,
        "audience_percentage": 4.9,
        "audience_index": 100,
        "datapoint_sample": 143734,
        "datapoint_size": 136246170,
        "datapoint_percentage": 100
      },
      "suffixes": [
        1,
        2,
        3,
        4
      ]
    },
    ...
  ]
}

Use the /v2/query/stats endpoint to fetch the data for this specific question.

curl -X POST "https://api.globalwebindex.com/v2/query/stats" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -d '{
            "question": "q42011"
        }'

{
  "meta": {
    "type": "DATAPOINTS",
    "question": "q42011",
    "splitter": ""
  },
   "data": [
    {
      "datapoint": "q42011_1",
      "waves": [
        "q1_2021",
        "q1_2022",
        "q1_2023",
        "q1_2024",
        "q2_2021",
        "q2_2022",
        "q2_2023",
        "q2_2024",
        "q3_2021",
        "q3_2022",
        "q3_2023",
        "q4_2020",
        "q4_2021",
        "q4_2022",
        "q4_2023"
      ],
      "metrics": {
        "positive_sample": 143734,
        "positive_size": 136246170,
        "audience_sample": 3390266,
        "audience_size": 2777556090,
        "audience_percentage": 4.9,
        "audience_index": 100,
        "datapoint_sample": 143734,
        "datapoint_size": 136246170,
        "datapoint_percentage": 100
      },
      "suffixes": [
        1,
        2,
        3,
        4
      ]
    },
    ...
  ]
}

Congratulations on retrieving your first piece of data on social media usage using GWI’s API! Now, let’s take it a step further. You want to identify which social media sites have the highest usage among males in Germany in 2024. To do this, go the the next quick start guide where you can learn how to apply advanced filters to refine your query and get these specific insights.

​
Key Takeaways:

  1. Use the Categories endpoints to locate questions step-by-step through namespaces, categories, and subcategories.

  2. Retrieve the unique code of the desired question.

  3. Use the /query/stats endpoint to fetch data related to the question, applying filters such as wave, location, or audience as needed.

This structured approach ensures you can pinpoint and retrieve the exact data you need from GWI’s comprehensive namespaces

Step 6: Retrieve Questions in the SubcategoryFurther Refining Your Query