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/attributes_hierarchy_tree \
--header 'Authorization: <api-key>'[
{
"insight_title": "<string>",
"insight_description": "<string>"
}
]AI Insights: Theme Breakdown Structure
Returns AI-generated insights about the hierarchical structure of attributes within clusters, explaining theme composition.
This endpoint analyzes how attributes nest within clusters (e.g., “Comfort” cluster contains “cushioning”, “fit”, “breathability”) and generates insights about theme composition and relationships. Helps understand the detailed structure of perception themes and how sub-attributes contribute to main themes.
When to use: User wants to understand theme composition, needs breakdown of cluster attributes, explores hierarchical relationships, or requires detailed theme structure insights.
Common user queries:
- “What makes up the comfort theme?”
- “Explain cluster attribute breakdown”
- “Show me theme structure insights”
- “How are attributes organized?”
- “Generate insights on theme composition”
- “What sub-themes exist?”
Returns: Array of insight objects explaining attribute hierarchy and theme structure.
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/attributes_hierarchy_tree \
--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 attribute.
Filter by a list of attributes. Values should be comma separated, without brackets or spaces
Filter by one specific brand.
Filter by a list of brands. Values should be comma separated, without brackets or spaces
Filter by a list of clusters. 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