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
curl --request GET \
--url https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/insights/brand_perception/cluster_share_by_brand \
--header 'Authorization: <api-key>'[
{
"insight_title": "<string>",
"insight_description": "<string>"
}
]AI Insights: Brand Strengths/Weaknesses
Returns AI-generated narrative insights about brand cluster distribution, explaining which brands excel in which themes (e.g., ‘Nike dominates comfort perception’).
This endpoint analyzes cluster share by brand data and generates strategic insights like “Brand X leads in comfort with 45% share but lags in price perception at 12%.” Includes narrative explanations, supporting data, and chart recommendations. Perfect for understanding competitive positioning and identifying brand strengths/weaknesses through AI interpretation.
When to use: User wants AI-interpreted cluster insights, needs narrative explanations of brand positioning, requires strategic recommendations, generates executive summaries, or prefers insights over raw metrics.
Common user queries:
- “Give me insights about brand strengths”
- “Explain cluster distribution patterns”
- “What are the key findings for brand positioning?”
- “Generate strategic insights on pros/cons”
- “Summarize brand performance by theme”
- “Which brands dominate which clusters?”
Returns: Array of insight objects with narrative descriptions and supporting chart data.
Current model in use: gpt-4o-mini.
Required permission: read:analysis
curl --request GET \
--url https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/insights/brand_perception/cluster_share_by_brand \
--header 'Authorization: <api-key>'[
{
"insight_title": "<string>",
"insight_description": "<string>"
}
]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
The cluster group to retrieve insights for.
all_cons, all_pros 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.
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
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