# GWI ## Docs - [Welcome](https://api.globalwebindex.com/docs/welcome.md) - [About GWI](https://api.globalwebindex.com/docs/overview/gwi.md) - [Which API Should I use? ](https://api.globalwebindex.com/docs/overview/api-comparison.md) - [Understanding GWI’s Syndicated Data Sets](https://api.globalwebindex.com/docs/overview/datasets.md) - [Combining Data from Different Namespaces](https://api.globalwebindex.com/docs/overview/allowed-combination-of-namespaces.md) - [Introduction to Key Metrics](https://api.globalwebindex.com/docs/overview/key-metrics.md) - [Introduction](https://api.globalwebindex.com/docs/spark-in-ai-assistants/introduction.md) - [Custom connector](https://api.globalwebindex.com/docs/spark-in-ai-assistants/claude/custom-connector.md) - [Desktop extension](https://api.globalwebindex.com/docs/spark-in-ai-assistants/claude/desktop-extension.md) - [Custom connector](https://api.globalwebindex.com/docs/spark-in-ai-assistants/chatgpt/custom-connector.md) - [Custom GPTs](https://api.globalwebindex.com/docs/spark-in-ai-assistants/chatgpt/custom-gpt.md) - [Copilot Studio](https://api.globalwebindex.com/docs/spark-in-ai-assistants/copilot-studio/custom-connector.md) - [Introduction](https://api.globalwebindex.com/docs/spark-api/getting-started/introduction.md) - [Prerequisites](https://api.globalwebindex.com/docs/spark-api/getting-started/prerequisites.md) - [Working with Multiple Data Sets](https://api.globalwebindex.com/docs/spark-api/getting-started/working-with-multiple-data-sets.md) - [Step 1: Authorization](https://api.globalwebindex.com/docs/spark-api/getting-started/authorization.md) - [Step 2: Structuring a Query in Spark API](https://api.globalwebindex.com/docs/spark-api/getting-started/structuring-query.md) - [Step 3: Retrieve an insight](https://api.globalwebindex.com/docs/spark-api/getting-started/insight.md) - [Step 4: Ask a follow up question](https://api.globalwebindex.com/docs/spark-api/getting-started/follow-up.md) - [Search platform audiences](https://api.globalwebindex.com/docs/spark-api/reference/audiences/search-platform-audiences.md): Returns relevant platform audiences filtered by search term, dataset codes, and optional audience exclusions. - [Chat with the service](https://api.globalwebindex.com/docs/spark-api/reference/chat/chat-with-the-service.md): Endpoint to chat with the service using a prompt and chat ID. - [List available datasets](https://api.globalwebindex.com/docs/spark-api/reference/datasets/list-available-datasets.md): Returns the datasets available for chat and insights. The route returns a hierarchical tree of folder and dataset nodes so clients can discover valid root/child dataset relationships. - [Retrieve Generic Insight details](https://api.globalwebindex.com/docs/spark-api/reference/insights/retrieve-generic-insight-details.md): Returns the detailed, “explore” representation of a Spark insight (attributes, audiences, calculations, etc.). - [Introduction](https://api.globalwebindex.com/docs/spark-mcp/getting-started/introduction.md) - [Prerequisites](https://api.globalwebindex.com/docs/spark-mcp/getting-started/prerequisites.md) - [Authorization](https://api.globalwebindex.com/docs/spark-mcp/getting-started/authorization.md) - [Overview](https://api.globalwebindex.com/docs/spark-mcp/integration-guide/overview.md) - [MCP Server](https://api.globalwebindex.com/docs/spark-mcp/integration-guide/mcp-api.md) - [MCP Remote](https://api.globalwebindex.com/docs/spark-mcp/integration-guide/mcp-remote.md) - [Custom connector](https://api.globalwebindex.com/docs/spark-mcp/integration-guide/claude/custom-connector.md) - [Desktop extension](https://api.globalwebindex.com/docs/spark-mcp/integration-guide/claude/desktop-extension.md) - [Custom connector](https://api.globalwebindex.com/docs/spark-mcp/integration-guide/chatgpt/custom-connector.md) - [Copilot Studio](https://api.globalwebindex.com/docs/spark-mcp/integration-guide/copilot-studio/custom-connector.md) - [Google Gemini CLI](https://api.globalwebindex.com/docs/spark-mcp/integration-guide/gemini-cli/guide.md) - [Slack-Slackbot ](https://api.globalwebindex.com/docs/spark-mcp/integration-guide/slack/slack.md) - [Changelog](https://api.globalwebindex.com/docs/spark-mcp/changelog.md): Version history and release notes for the Spark MCP Server - [Execute GWI MCP tool calls](https://api.globalwebindex.com/docs/spark-mcp/reference/mcp-tools/execute-gwi-mcp-tool-calls.md): This endpoint handles MCP tool calls through JSON-RPC. Supported tools: - [Introduction](https://api.globalwebindex.com/docs/platform-api/getting-started/introduction.md) - [Prerequisites](https://api.globalwebindex.com/docs/platform-api/getting-started/prerequisites.md) - [Rules of our API](https://api.globalwebindex.com/docs/platform-api/rules-of-our-api.md) - [Working with Multiple Data Sets](https://api.globalwebindex.com/docs/platform-api/getting-started/working-with-multiple-data-sets.md) - [Step 1: Authorization](https://api.globalwebindex.com/docs/platform-api/getting-started/authorization.md) - [Step 2: Understanding GWI's Data Structure](https://api.globalwebindex.com/docs/platform-api/getting-started/gwi-data-structure.md) - [Step 3: Find the Question You Need](https://api.globalwebindex.com/docs/platform-api/getting-started/find-question.md) - [Step 4: Access Categories in the GWI Core namespace](https://api.globalwebindex.com/docs/platform-api/getting-started/access-categories.md) - [Step 5: Retrieve Subcategories](https://api.globalwebindex.com/docs/platform-api/getting-started/retrieve-subcategories.md) - [Step 6: Retrieve Questions in the Subcategory](https://api.globalwebindex.com/docs/platform-api/getting-started/questions-from-subcategory.md) - [Step 7: Query Data for the Question](https://api.globalwebindex.com/docs/platform-api/getting-started/query-data.md) - [Further Refining Your Query ](https://api.globalwebindex.com/docs/platform-api/quickstart-guide-continued/advanced-filtering.md) - [Step 1: Understanding Namespaces](https://api.globalwebindex.com/docs/platform-api/quickstart-guide-continued/understanding-namespaces.md) - [Step 2: Filter by Waves](https://api.globalwebindex.com/docs/platform-api/quickstart-guide-continued/filter-by-waves.md) - [Step 3: Filter by Locations](https://api.globalwebindex.com/docs/platform-api/quickstart-guide-continued/filter-by-locations.md) - [Step 4: Filter by Splitters](https://api.globalwebindex.com/docs/platform-api/quickstart-guide-continued/apply-splitter.md) - [Step 5: Combine Filters in a Stats Query](https://api.globalwebindex.com/docs/platform-api/quickstart-guide-continued/stats-query.md) - [Step 6: Interpret the Results](https://api.globalwebindex.com/docs/platform-api/quickstart-guide-continued/interpret-results.md) - [Find the Right Question](https://api.globalwebindex.com/docs/platform-api/use-cases/find-question.md) - [Create Audiences](https://api.globalwebindex.com/docs/platform-api/use-cases/create-audiences.md) - [Apply Audiences](https://api.globalwebindex.com/docs/platform-api/use-cases/apply-audiences.md) - [Create Crosstabs](https://api.globalwebindex.com/docs/platform-api/use-cases/create-crosstabs.md) - [Compare Results by Location](https://api.globalwebindex.com/docs/platform-api/use-cases/compare-by-location.md) - [Examine Trends over Time](https://api.globalwebindex.com/docs/platform-api/use-cases/trends-over-time.md) - [Guide](https://api.globalwebindex.com/docs/platform-api/transition-guide/guide.md) - [v2 Audience Detail](https://api.globalwebindex.com/docs/platform-api/reference/audiences/v2-audience-detail.md): Retrieve a single audience for the current user. Use this endpoint to throttle API requests to just query a given audience, rather than all of your audiences. - [v2 Create Audience](https://api.globalwebindex.com/docs/platform-api/reference/audiences/v2-create-audience.md): Create a new audience for the current user. You can specify the attributes that you want to define your audiences, choosing from all data points in our taxonomy. - [v2 Delete Audience](https://api.globalwebindex.com/docs/platform-api/reference/audiences/v2-delete-audience.md): Delete an audience owned by the current user. - [v2 Filter Audiences](https://api.globalwebindex.com/docs/platform-api/reference/audiences/v2-filter-audiences.md): Filter audiences by name, flags, folder_id with pagination and sorting options. - [v2 List Audiences](https://api.globalwebindex.com/docs/platform-api/reference/audiences/v2-list-audiences.md): Retrieve all audiences for the current user that you have access to in your account. - [v2 Make Audience Public](https://api.globalwebindex.com/docs/platform-api/reference/audiences/v2-make-audience-public.md): Makes an audience public, allowing any authorized user to access it - [v2 Replace Audience](https://api.globalwebindex.com/docs/platform-api/reference/audiences/v2-replace-audience.md): Replace an audience for the current user. You can specify the attributes that you want to define your audiences, choosing from all data points in our taxonomy. - [v2 Update Audience](https://api.globalwebindex.com/docs/platform-api/reference/audiences/v2-update-audience.md): Update only some attribute(s) of existing audience (partial update). - [Get v2tokenvalidate](https://api.globalwebindex.com/docs/platform-api/reference/authorization/get-v2tokenvalidate.md) - [v2 Categories Filter](https://api.globalwebindex.com/docs/platform-api/reference/categories/v2-categories-filter.md): Filter the list of accessible categories - [v2 Category Detail](https://api.globalwebindex.com/docs/platform-api/reference/categories/v2-category-detail.md): Show detail info of given category. - [v1 Calculate Chart Metrics](https://api.globalwebindex.com/docs/platform-api/reference/charts/v1-calculate-chart-metrics.md): Get calculated metrics with the help of extenral calculations service (v2). - [v1 Chart Detail](https://api.globalwebindex.com/docs/platform-api/reference/charts/v1-chart-detail.md): Get user's chart detail based on given JWT token and chart id. - [v1 Charts Search](https://api.globalwebindex.com/docs/platform-api/reference/charts/v1-charts-search.md): Search user's chart based on given JWT token and chart name. - [v1 Create Chart](https://api.globalwebindex.com/docs/platform-api/reference/charts/v1-create-chart.md): Create user's chart. If audiences on this chart are not accessible for the user, it creates new ones. - [v1 Delete Charts](https://api.globalwebindex.com/docs/platform-api/reference/charts/v1-delete-charts.md): Delete multiple charts by specifying their ids. - [v1 Duplicate Chart](https://api.globalwebindex.com/docs/platform-api/reference/charts/v1-duplicate-chart.md): Duplicate a single chart. If the chart is shared with the user or user is the owner of it, it will be saved as new. Audiences of the chart will be saved as new also if user has not access to them. - [v1 List Charts](https://api.globalwebindex.com/docs/platform-api/reference/charts/v1-list-charts.md): Get all user's charts based on JWT token. - [v1 Rename Chart](https://api.globalwebindex.com/docs/platform-api/reference/charts/v1-rename-chart.md): Rename a chart. - [v1 Update Chart](https://api.globalwebindex.com/docs/platform-api/reference/charts/v1-update-chart.md): Update a user chart. This endpoint does not handle audiences the user has not access to. - [v2 Create Crosstab](https://api.globalwebindex.com/docs/platform-api/reference/crosstabs/v2-create-crosstab.md): Create a crosstab - [v2 Crosstab Detail](https://api.globalwebindex.com/docs/platform-api/reference/crosstabs/v2-crosstab-detail.md): Get the crosstab details by project ID - [v2 Delete Crosstab](https://api.globalwebindex.com/docs/platform-api/reference/crosstabs/v2-delete-crosstab.md): Delete crosstab by project ID - [v2 List Crosstabs](https://api.globalwebindex.com/docs/platform-api/reference/crosstabs/v2-list-crosstabs.md): List crosstabs with metadata for current user. - [v2 Replace Crosstab](https://api.globalwebindex.com/docs/platform-api/reference/crosstabs/v2-replace-crosstab.md): Replace Crosstab - [v2 Update crosstab](https://api.globalwebindex.com/docs/platform-api/reference/crosstabs/v2-update-crosstab.md): Update crosstab by project ID - [v3 Categories](https://api.globalwebindex.com/docs/platform-api/reference/insights/v3-categories.md): Get all Insight Categories. - [v3 Insight Detail](https://api.globalwebindex.com/docs/platform-api/reference/insights/v3-insight-detail.md): Get an insight using its id. - [v3 Insight Download URL](https://api.globalwebindex.com/docs/platform-api/reference/insights/v3-insight-download-url.md): Download an insight using its id. - [v3 Insights Filter](https://api.globalwebindex.com/docs/platform-api/reference/insights/v3-insights-filter.md): Get all insights using filtering. - [v3 Insights Search](https://api.globalwebindex.com/docs/platform-api/reference/insights/v3-insights-search.md): Search insights using term. - [v3 Related Insights](https://api.globalwebindex.com/docs/platform-api/reference/insights/v3-related-insights.md): Get some related insights for a specific insight using its id. - [v2 Locations Filter](https://api.globalwebindex.com/docs/platform-api/reference/locations/v2-locations-filter.md): Retrieve accessible locations that satisfy filter criteria. - [v2 Namespaces Filter](https://api.globalwebindex.com/docs/platform-api/reference/namespaces/v2-namespaces-filter.md): Show detail info of given namespaces - [v2 Audience Wave Counts Query](https://api.globalwebindex.com/docs/platform-api/reference/query/v2-audience-wave-counts-query.md): Returns wave counts - [v2 Crosstab Bulk Query](https://api.globalwebindex.com/docs/platform-api/reference/query/v2-crosstab-bulk-query.md): For any query (JSON object) with audiences and filters in request body it gives back a response with results for specific Crosstab metrics according to the query. - [v2 Crosstab Cell Query](https://api.globalwebindex.com/docs/platform-api/reference/query/v2-crosstab-cell-query.md): For any query (JSON object) with audiences and filters in request body it gives back a response with results for specific Crosstab metrics according to the query. - [v2 Stats Query](https://api.globalwebindex.com/docs/platform-api/reference/query/v2-stats-query.md): For any query (JSON object) with question, audiences and filters in request body it responses with results for chart builder metrics according the query. - [v3 Audience Wave Counts Query](https://api.globalwebindex.com/docs/platform-api/reference/query/v3-audience-wave-counts-query.md): Returns sample for waves. - [v2 Question Detail](https://api.globalwebindex.com/docs/platform-api/reference/questions/v2-question-detail.md): Show detail info of given question - [v2 Questions Filter](https://api.globalwebindex.com/docs/platform-api/reference/questions/v2-questions-filter.md): Filter Questions - [v3 Questions Filter](https://api.globalwebindex.com/docs/platform-api/reference/questions/v3-questions-filter.md): Filter Questions - [v3 Questions Search](https://api.globalwebindex.com/docs/platform-api/reference/questions/v3-questions-search.md): Search Questions - [v2 Splitters filter](https://api.globalwebindex.com/docs/platform-api/reference/splitters/v2-splitters-filter.md): Filter splitters and show their details. - [v3 Taxonomy](https://api.globalwebindex.com/docs/platform-api/reference/taxonomy/v3-taxonomy.md): Streams taxonomy accessible to the user. - [v2 Waves Filter](https://api.globalwebindex.com/docs/platform-api/reference/waves/v2-waves-filter.md): Retrieve accessible waves that satisfy filter criteria. - [Dictionary](https://api.globalwebindex.com/docs/dictionary/dictionary.md) ## OpenAPI Specs - [spark-mcp-v2beta](https://api.globalwebindex.com/docs/openapi/spark-mcp/spark-mcp-v2beta.json) - [spark-api](https://api.globalwebindex.com/docs/openapi/spark/spark-api.json) - [spark-mcp](https://api.globalwebindex.com/docs/openapi/spark-mcp/spark-mcp.json) - [localcopy-surveys](https://api.globalwebindex.com/docs/openapi/platform/localcopy-surveys.json) - [audiences](https://api.globalwebindex.com/docs/openapi/platform/audiences.json) - [platform-crosstabs-api](https://api.globalwebindex.com/docs/openapi/platform/platform-crosstabs-api.json) - [localcopy-labels](https://api.globalwebindex.com/docs/openapi/platform/localcopy-labels.json) - [v3-audience-wave-size-query](https://api.globalwebindex.com/docs/openapi/platform/v3-audience-wave-size-query.json) - [platform-charts-api](https://api.globalwebindex.com/docs/openapi/platform/platform-charts-api.json) - [platform2-service-layer](https://api.globalwebindex.com/docs/openapi/platform/platform2-service-layer.json) - [platform2-insights-api](https://api.globalwebindex.com/docs/openapi/platform/platform2-insights-api.json) - [users](https://api.globalwebindex.com/docs/openapi/platform/users.json) - [stats-query](https://api.globalwebindex.com/docs/openapi/platform/stats-query.json) - [platform-api](https://api.globalwebindex.com/docs/openapi/platform/platform-api.json) - [crosstab-query](https://api.globalwebindex.com/docs/openapi/platform/crosstab-query.json) - [audiences-intersection-query](https://api.globalwebindex.com/docs/openapi/platform/audiences-intersection-query.json) - [audience-wave-size-query](https://api.globalwebindex.com/docs/openapi/platform/audience-wave-size-query.json) - [openapi](https://api.globalwebindex.com/docs/api-reference/openapi.json)