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 Target Persona
curl --request GET \
--url https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/metrics/summary/brand_composite_score_by_persona \
--header 'Authorization: <api-key>'[
{
"brand": "<string>",
"persona": "<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 Target Persona
Shows composite performance scores broken down by customer persona,
revealing which brands resonate with different audience segments.
This endpoint calculates scores separately for each persona (e.g.,
"young professionals", "athletes", "parents"), showing how brand performance varies across target audiences. Nike might score 90 with athletes but only 60 with seniors, indicating strong segmentation. Essential for audience-specific marketing strategies and identifying underperforming segments to target.
**When to use:** User wants to see brand performance by audience segment, identify which personas favor which brands, find persona-specific strengths/weaknesses, or optimize messaging for specific demographics.
**Common user queries:**
- "How does Nike perform with athletes vs parents?"
- "Show brand scores by persona"
- "Which brands resonate with young professionals?"
- "Compare performance across audience segments"
- "Get persona-specific brand rankings"
- "What's our score with each customer type?"
**Returns:** Array of brands with composite scores for each persona.
Example: [{"brand": "Nike", "persona": "Athletes", "composite_score": 92.0}, {"brand": "Nike",
"persona": "Parents", "composite_score": 68.5}]
Required permission: `read:analysis`.
GET
/
v1
/
organizations
/
{organization_id}
/
workspaces
/
{workspace_id}
/
analyses
/
{analysis_id}
/
metrics
/
summary
/
brand_composite_score_by_persona
Brand Performance by Target Persona
curl --request GET \
--url https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/metrics/summary/brand_composite_score_by_persona \
--header 'Authorization: <api-key>'[
{
"brand": "<string>",
"persona": "<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