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
Complete Audience Segment Profiles
curl --request GET \
--url https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/metrics/target_audience/segments \
--header 'Authorization: <api-key>'[
{
"brand": "Nike",
"collection_date": "2024-10-24",
"name": "Young Urban Professionals",
"age_range": "25-34",
"gender": "all",
"area_type": "urban",
"household_type": "single",
"cost_tolerance": "medium",
"challenges": [
"time shortage",
"brand confusion",
"budget limit"
],
"decision_making": [
"price",
"sustainability",
"peer opinion"
],
"purchase_influences": [
"ads",
"social media",
"reviews"
],
"media_channels": [
"instagram",
"youtube",
"tiktok"
],
"sources": [
"source_1",
"source_2"
],
"google_ads_segments": [
{
"category_id": "80429",
"segment_name": "/Apparel & Accessories/Activewear",
"display": "YES",
"gmail": "YES",
"discovery": "YES",
"search": "YES",
"shopping": "NO",
"video": "YES",
"generated_description": "People interested in activewear"
}
]
}
]Metrics
Complete Audience Segment Profiles
Returns detailed profiles for all audience segments, including demographics, beh
aviors, challenges, and preferences in one comprehensive response.
This endpoint provides complete segment definitions with all attributes: age,
gender, location, household, cost tolerance, plus psychographic data like challenges, decision-making factors, purchase influences, and media channels. Perfect for creating personas, understanding complete customer profiles, and building targeted campaigns. Each segment represents a distinct audience cohort with unique characteristics.
**When to use:** User wants complete audience profiles, needs full segment details, creates marketing personas, requires psychographic insights beyond demographics, or builds targeted campaign strategies.
**Common user queries:**
- "Show me all audience segments for Nike"
- "What are the complete customer profiles?"
- "Get detailed segment information"
- "List all personas with their characteristics"
- "What challenges do different segments face?"
- "Show full audience breakdown"
**Returns:** Array of detailed segment objects with demographics, psychographics, and Google Ads targeting data.
Example: [{"name": "Young Urban Professionals", "age_range": "25-34", "gender": "all",
"challenges": ["time shortage"], "media_channels": ["instagram", "youtube"]}]
Required permission: `read:analysis`.
GET
/
v1
/
organizations
/
{organization_id}
/
workspaces
/
{workspace_id}
/
analyses
/
{analysis_id}
/
metrics
/
target_audience
/
segments
Complete Audience Segment Profiles
curl --request GET \
--url https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/metrics/target_audience/segments \
--header 'Authorization: <api-key>'[
{
"brand": "Nike",
"collection_date": "2024-10-24",
"name": "Young Urban Professionals",
"age_range": "25-34",
"gender": "all",
"area_type": "urban",
"household_type": "single",
"cost_tolerance": "medium",
"challenges": [
"time shortage",
"brand confusion",
"budget limit"
],
"decision_making": [
"price",
"sustainability",
"peer opinion"
],
"purchase_influences": [
"ads",
"social media",
"reviews"
],
"media_channels": [
"instagram",
"youtube",
"tiktok"
],
"sources": [
"source_1",
"source_2"
],
"google_ads_segments": [
{
"category_id": "80429",
"segment_name": "/Apparel & Accessories/Activewear",
"display": "YES",
"gmail": "YES",
"discovery": "YES",
"search": "YES",
"shopping": "NO",
"video": "YES",
"generated_description": "People interested in activewear"
}
]
}
]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 equal to the specified date. YYYY-MM-DD format
Filter by a collection date being greater than the specified date. YYYY-MM-DD format
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
Filter by a collection date being less than or equal the specified date. YYYY-MM-DD format
Available options:
csv, json Filter by one specific source.
Available options:
claude-3-5-sonnet, claude-4-5-sonnet, claude-4-6-sonnet, claude-4-sonnet, deepseek-chat, deepseek-reasoner, gemini-1.5-pro, gemini-2.0-flash, gemini-2.5-flash, gemini-2.5-flash-grounded, gemini-2.5-flash-lite, gemini-3-flash-preview, google-ai-mode, gpt-3.5-turbo, gpt-4-turbo, gpt-4o, gpt-4o-mini-search, gpt-5, gpt-5.2, gpt-5.4-mini, meta-llama-3.1-70B-instruct-turbo, meta-llama-3.2-70B-instruct-turbo, meta-llama-3.3-70B-instruct-turbo, meta-llama-4-maverick, mistral-7B-instruct, perplexity-sonar, rufus Filter by a list of sources. Values should be comma separated, without brackets or spaces
Available options:
claude-3-5-sonnet, claude-4-5-sonnet, claude-4-6-sonnet, claude-4-sonnet, deepseek-chat, deepseek-reasoner, gemini-1.5-pro, gemini-2.0-flash, gemini-2.5-flash, gemini-2.5-flash-grounded, gemini-2.5-flash-lite, gemini-3-flash-preview, google-ai-mode, gpt-3.5-turbo, gpt-4-turbo, gpt-4o, gpt-4o-mini-search, gpt-5, gpt-5.2, gpt-5.4-mini, meta-llama-3.1-70B-instruct-turbo, meta-llama-3.2-70B-instruct-turbo, meta-llama-3.3-70B-instruct-turbo, meta-llama-4-maverick, mistral-7B-instruct, perplexity-sonar, rufus ⌘I