Insights
AI-Generated Strategic Insights
Returns AI-generated strategic insights and recommendations based on analysis da
ta, providing narrative summaries with supporting data.
This endpoint delivers high-level insights automatically generated from the metrics,
such as "Reebok is perceived as more sporty than competitors but less comfortable." Each insight includes a title, narrative description, supporting raw data, and suggested chart type for visualization. Perfect for executive summaries, automated reporting, and data storytelling.
**When to use:** User wants strategic summaries, needs narrative insights, requires executive-friendly explanations, generates automated reports, or wants AI-interpreted findings rather than raw metrics.
**Common user queries:**
- "Give me insights for this analysis"
- "What are the key findings?"
- "Show strategic recommendations"
- "Summarize the analysis"
- "What should I know about brand perception?"
- "Generate insights report"
**Returns:** Array of insight objects with titles, descriptions, supporting data, and chart recommendations.
Example: [{{"insight_title": "Brand Positioning Gap", "insight_description": "Nike leads in
style but trails in comfort...", "raw_data": {{}}, "chart_type": "stacked_bar"}}]
GET
AI-Generated Strategic Insights
Path Parameters
Query Parameters
Filter by a list of persona IDs. Values should be comma separated, without brackets or spaces. The IDs are resolved to the persona labels recorded on the analysis, so this returns the same rows as the equivalent persona__in call. Use it for analyses that carry persona_ids; analyses predating persona records have none, and must be filtered with persona or persona__in. An ID that is not one of the analysis's personas matches no rows.
Filter by one specific source.
Available options:
claude-3-5-sonnet, claude-4-5-sonnet, claude-4-6-sonnet, claude-4-sonnet, deepseek-chat, deepseek-reasoner, deepseek-v3.2-maas, gemini-1.5-pro, gemini-2.0-flash, gemini-2.5-flash, gemini-2.5-flash-grounded, gemini-2.5-flash-lite, gemini-3-flash-preview, gemini-3.5-flash-lite, google-ai-mode, gpt-3.5-turbo, gpt-4-turbo, gpt-4o, gpt-4o-mini-search, gpt-5, gpt-5.2, gpt-5.4-mini, meta-llama-3.1-70B-instruct-turbo, meta-llama-3.2-70B-instruct-turbo, meta-llama-3.3-70B-instruct-turbo, meta-llama-4-maverick, mistral-7B-instruct, muse-spark-1.2, muse-spark-1.3, perplexity-sonar, rufus Filter by a list of sources. Values should be comma separated, without brackets or spaces
Available options:
claude-3-5-sonnet, claude-4-5-sonnet, claude-4-6-sonnet, claude-4-sonnet, deepseek-chat, deepseek-reasoner, deepseek-v3.2-maas, gemini-1.5-pro, gemini-2.0-flash, gemini-2.5-flash, gemini-2.5-flash-grounded, gemini-2.5-flash-lite, gemini-3-flash-preview, gemini-3.5-flash-lite, google-ai-mode, gpt-3.5-turbo, gpt-4-turbo, gpt-4o, gpt-4o-mini-search, gpt-5, gpt-5.2, gpt-5.4-mini, meta-llama-3.1-70B-instruct-turbo, meta-llama-3.2-70B-instruct-turbo, meta-llama-3.3-70B-instruct-turbo, meta-llama-4-maverick, mistral-7B-instruct, muse-spark-1.2, muse-spark-1.3, perplexity-sonar, rufus AI-Generated Strategic Insights