AI Insights: Market Share Evolution

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>"
  }
]

Insights

AI Insights: Market Share Evolution

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:

“Generate insights on market share trends”
“Which brands are gaining dominance?”
“Explain voice share evolution”
“What are the competitive dynamics?”
“Show market shift insights”
“Summarize competitive momentum”

Returns: Array of insight objects interpreting market share trends with competitive implications. Current model in use: gpt-5.4-mini.

Required permission: read:analysis

GET

organizations

{organization_id}

workspaces

{workspace_id}

analyses

{analysis_id}

insights

brand_awareness

share_of_voice_timeseries

AI Insights: Market Share Evolution

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>"
  }
]

Authorizations

Authorization

string

header

required

Path Parameters

analysis_id

string<uuid>

required

A UUID string identifying the analysis.

organization_id

string<uuid>

required

A UUID string identifying the organization.

workspace_id

string<uuid>

required

A UUID string identifying the workspace.

Response

200 - application/json

insight_title

string

required

insight_description

string

required

AI Insights: Platform-Specific Market Share

AI Insights: Brand Attribute Scores