Core API
- GETBrand Ranking Positions
- GETOverall Brand Awareness Score
- GETBrand Awareness Score Evolution
- GETBrand Mention Frequency
- GETCombined Brand Awareness Metrics
- GETBrand Mention Trends Over Time
- GETBrand Market Share Metric
- GETBrand Market Share by AI Model
- GETMarket Share Trends Over Time
- GETBrand Ratings on Specific Attributes
- GETHierarchical Perception Tree View
- GETBrand Perception by LLM Source
- GETBrand Ownership of Each Theme
- GETList Pros and Cons Cluster Groups
- GETOverall Cluster Share Distribution
- GETCluster Distribution Per Brand
- GETList All Attributes with Cluster Mapping
- GETBrand Perception Raw Pros And Cons
- GETOverall Source Authority Score
- GETSource Authority by AI Model
- GETComplete Source Authority Metrics
- GETSource Domain Ranking Positions
- GETSource Citation Frequency
- GETSource Citation Counts
- GETTopic-Specific Source Authority Scores
- GETTopic-Specific Source Authority by AI Model
- GETComplete Source Metrics by Topic
- GETSource Rankings for Specific Topics
- GETSource Citation Frequency by Topic
- GETSource Citation Counts by Topic
- GETAvailable AI Models List
- GETAll Information Sources
- GETComprehensive Domain Influence Breakdown
- GETTop and Bottom Reddit Communities
- GETDomain Influence Rankings
- GETDomain Influence Trends Over Time
- GETIndividual URL Performance Metrics
- GETCitation Rates by Platform Category
- GETSocial Media Sources with Context
- GETOverall Brand Performance Score
- GETBrand Performance by Market/Country
- GETBrand Performance by Target Persona
- GETBrand Performance by AI Model
- GETAudience Age Demographics
- GETAudience Geographic Type Demographics
- GETAvailable Audience Data Dates
- GETAudience Price Sensitivity
- GETAudience Gender Demographics
- GETGoogle Ads Targeting Categories
- GETAudience Household Demographics
- GETComplete Audience Segment Profiles
- GETDetailed Asset Performance Metrics
- GETAll Asset Evaluations Summary
- GETReddit insights
Search API
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"
}
]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.
Authorizations
Path Parameters
A UUID string identifying the analysis.
A UUID string identifying the organization.
A UUID string identifying the workspace.
Query Parameters
Filter by one specific brand.
Filter by a collection date being greater than or equal the specified date. YYYY-MM-DD format
Filter by a collection date being less than the specified date. YYYY-MM-DD format
Interval of the timeseries.
Available options:
month, week Response
200 - application/json
Pattern:
^-?\d{0,1}(?:\.\d{0,6})?$Pattern:
^-?\d{0,1}(?:\.\d{0,6})?$Pattern:
^-?\d{0,1}(?:\.\d{0,6})?$Pattern:
^-?\d{0,1}(?:\.\d{0,6})?$⌘I