AI Insights: Complete Brand Awareness Profile

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

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

Insights

AI Insights: Complete Brand Awareness Profile

Returns AI-generated insights combining mention frequency and ranking data, providing holistic brand awareness analysis.

This endpoint analyzes both metrics together and generates insights like “Nike achieves both high frequency (85%) and top position (1.2), indicating market leadership, while Brand X has decent frequency (60%) but poor position (4.5), suggesting quality perception issues.” Identifies balanced performers, frequency-position gaps, and strategic opportunities.

When to use: User wants comprehensive awareness insights, needs combined metric interpretation, identifies balanced vs unbalanced performance, or requires holistic strategic recommendations.

Common user queries:

“Generate complete awareness insights”
“Explain overall brand performance”
“Which brands excel in both metrics?”
“Summarize combined awareness patterns”
“What’s the full awareness picture?”
“Show comprehensive insights”

Returns: Array of insight objects interpreting combined awareness metrics with strategic 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

mention_rate_and_average_position

AI Insights: Complete Brand Awareness Profile

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

AI Insights: Brand Awareness Trends