Core API
- GETAI-Generated Strategic Insights
- GETAI Insights: Brand Ranking Patterns
- GETAI Insights: Brand Awareness Levels
- GETAI Insights: Complete Brand Awareness Profile
- GETAI Insights: Brand Awareness Trends
- GETAI Insights: Market Dominance Patterns
- GETAI Insights: Platform-Specific Market Share
- GETAI Insights: Market Share Evolution
- GETAI Insights: Brand Attribute Scores
- GETAI Insights: Theme Breakdown Structure
- GETAI Insights: Brand Themes Across AI Models
- GETAI Insights: Brand Strengths/Weaknesses
Search API
AI-Generated Strategic Insights
curl --request GET \
--url https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/insights \
--header 'Authorization: <api-key>'[
{
"insight_title": "Perceived Brand Image of Reebok",
"insight_description": "Based on the analysis, Reebok is perceived as more sporty than Nike,\n Adidas and Puma. It is also perceived as less comfortable than Nike and Puma. Working on the\n brand's image for style and comfort might be beneficial.",
"raw_data": {
"Nike": {
"Comfortable": "0.3000",
"Sporty": "0.2500",
"Style": "0.4500"
},
"Adidas": {
"Comfortable": "0.2000",
"Sporty": "0.1550",
"Style": "0.6450"
},
"Puma": {
"Comfortable": "0.4000",
"Sporty": "0.4545",
"Style": "0.1455"
},
"Reebok": {
"Comfortable": "0.1500",
"Sporty": "0.6000",
"Style": "0.2500"
}
},
"chart_type": "stacked_bar"
}
]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
/
v1
/
organizations
/
{organization_id}
/
workspaces
/
{workspace_id}
/
analyses
/
{analysis_id}
/
insights
AI-Generated Strategic Insights
curl --request GET \
--url https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/insights \
--header 'Authorization: <api-key>'[
{
"insight_title": "Perceived Brand Image of Reebok",
"insight_description": "Based on the analysis, Reebok is perceived as more sporty than Nike,\n Adidas and Puma. It is also perceived as less comfortable than Nike and Puma. Working on the\n brand's image for style and comfort might be beneficial.",
"raw_data": {
"Nike": {
"Comfortable": "0.3000",
"Sporty": "0.2500",
"Style": "0.4500"
},
"Adidas": {
"Comfortable": "0.2000",
"Sporty": "0.1550",
"Style": "0.6450"
},
"Puma": {
"Comfortable": "0.4000",
"Sporty": "0.4545",
"Style": "0.1455"
},
"Reebok": {
"Comfortable": "0.1500",
"Sporty": "0.6000",
"Style": "0.2500"
}
},
"chart_type": "stacked_bar"
}
]Documentation Index
Fetch the complete documentation index at: https://docs.shareofmodel.ai/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Path Parameters
A UUID string identifying the analysis.
A UUID string identifying the organization.
A UUID string identifying the workspace.
Query Parameters
Filter by one specific brand.
Filter by a list of brands. Values should be comma separated, without brackets or spaces
Filter by a collection date being equal to the specified date. YYYY-MM-DD format
Filter by a collection date being greater than the specified date. YYYY-MM-DD format
Filter by a collection date being greater than or equal the specified date. YYYY-MM-DD format
Filter by a collection date being less than the specified date. YYYY-MM-DD format
Filter by a collection date being less than or equal the specified date. YYYY-MM-DD format
Filter by one specific country.
Filter by a list of countries. Values should be comma separated, without brackets or spaces
Filter by one specific persona.
Filter by a list of personas. Values should be comma separated, without brackets or spaces
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, 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, 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, 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, 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, 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, perplexity-sonar, rufus ⌘I