Brand Performance by Market/Country

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

[
  {
    "brand": "<string>",
    "country": "<string>",
    "brand_awareness_score": "<string>",
    "pros_and_cons_score": "<string>",
    "attributes_score": "<string>",
    "composite_score": "<string>",
    "month": "2023-12-25",
    "week": "2023-12-25"
  }
]

Metrics

Brand Performance by Market/Country

Shows composite performance scores broken down by country or market, revealing geographic variations in brand strength. This endpoint calculates scores separately for each market, showing how brands perform regionally. Nike might dominate in the US (score 90) but underperform in France (score 55), indicating market-specific opportunities. Critical for international expansion strategies, identifying priority markets, and understanding regional competitive dynamics. **When to use:** User wants to compare brand performance across countries, identify strongest/weakest markets, prioritize geographic expansion, analyze regional competition, or find market-specific opportunities. **Common user queries:** - "How does Nike perform in different countries?" - "Compare brand scores across markets" - "Which country has the highest brand performance?" - "Show geographic performance breakdown" - "Where should we focus our expansion?" - "Get scores by country" **Returns:** Array of brands with composite scores for each country. Example: [{"brand": "Nike", "country": "US", "composite_score": 88.5}, {"brand": "Nike", "country": "FR", "composite_score": 65.0}] Required permission: `read:analysis`.

GET

/

v1

/

organizations

/

{organization_id}

/

workspaces

/

{workspace_id}

/

analyses

/

{analysis_id}

/

metrics

/

summary

/

brand_composite_score_by_country

Brand Performance by Market/Country

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

[
  {
    "brand": "<string>",
    "country": "<string>",
    "brand_awareness_score": "<string>",
    "pros_and_cons_score": "<string>",
    "attributes_score": "<string>",
    "composite_score": "<string>",
    "month": "2023-12-25",
    "week": "2023-12-25"
  }
]

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.

Query Parameters

brand

string

required

Filter by one specific brand.

collection_date__gte

string<date>

required

Filter by a collection date being greater than or equal the specified date. YYYY-MM-DD format

collection_date__lt

string<date>

required

Filter by a collection date being less than the specified date. YYYY-MM-DD format

period

enum<string>

Interval of the timeseries.

Available options:

month,

week

Response

200 - application/json

brand

string

required

country

string

required

brand_awareness_score

string<decimal>

required

Pattern: ^-?\d{0,1}(?:\.\d{0,6})?$

pros_and_cons_score

string<decimal>

required

Pattern: ^-?\d{0,1}(?:\.\d{0,6})?$

attributes_score

string<decimal>

required

Pattern: ^-?\d{0,1}(?:\.\d{0,6})?$

composite_score

string<decimal>

required

Pattern: ^-?\d{0,1}(?:\.\d{0,6})?$

month

string<date>

week

string<date>

Overall Brand Performance Score

Brand Performance by Target Persona