curl --request GET \
--url https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/insights/brand_awareness/share_of_voice_timeseries \
--header 'Authorization: <api-key>'[
{
"insight_title": "<string>",
"insight_description": "<string>"
}
]Returns AI-generated insights about market share trends over time, identifying shifts in competitive dominance.
This endpoint analyzes voice share changes and generates insights like “Nike’s market share grew from 40% to 45% while Adidas dropped from 28% to 24%, indicating Nike’s strengthening dominance and Adidas’s weakening position.” Identifies competitive momentum, market disruption, and share shifts.
When to use: User wants competitive trend insights, needs market share interpretation, identifies momentum changes, tracks competitive shifts, or requires temporal competitive analysis.
Common user queries:
Returns: Array of insight objects interpreting market share trends with competitive implications.
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_awareness/share_of_voice_timeseries \
--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.
A UUID string identifying the analysis.
A UUID string identifying the organization.
A UUID string identifying the workspace.