AI Insights: Brand Awareness Trends

curl --request GET \
  --url https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/insights/brand_awareness/mention_rate_timeseries \
  --header 'Authorization: <api-key>'

[
  {
    "insight_title": "<string>",
    "insight_description": "<string>"
  }
]

Insights

AI Insights: Brand Awareness Trends

Returns AI-generated insights about brand awareness trends over time, identifying growth, decline, and momentum patterns.

This endpoint analyzes mention rate changes and generates insights like “Nike’s awareness grew 15% month-over-month while Adidas declined 8%, indicating shifting market dynamics and potential campaign impact.” Identifies trending brands, seasonal patterns, and inflection points.

When to use: User wants trend insights, needs growth/decline interpretation, identifies momentum shifts, measures campaign impact through insights, or requires temporal pattern analysis.

Common user queries:

“Generate insights on awareness trends”
“Which brands are growing?”
“Explain mention rate changes over time”
“What are the trend patterns?”
“Show growth/decline insights”
“Summarize temporal dynamics”

Returns: Array of insight objects interpreting trend data with growth/decline analysis. 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

mention_rate_timeseries

AI Insights: Brand Awareness Trends

curl --request GET \
  --url https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/insights/brand_awareness/mention_rate_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: Complete Brand Awareness Profile

AI Insights: Market Dominance Patterns