Metrics

Brand Perception by LLM Source

Shows how a brand's perception themes vary across different AI models (ChatGPT, Gemini, Claude, etc.), revealing consistency or divergence in brand perception. This endpoint breaks down a specific brand's cluster distribution by each AI source/LLM. For example, ChatGPT might perceive Nike as 70% comfortable while Gemini sees it as only 10% comfortable. Critical for identifying perception inconsistencies across different AI platforms and understanding which LLMs favor which brand attributes. **When to use:** User wants to analyze perception consistency across AI models, identify which LLMs have different brand perceptions, compare ChatGPT vs Gemini brand profiles, or validate brand positioning across multiple sources. **Common user queries:** - "How does Nike's perception differ between ChatGPT and Gemini?" - "Show me cluster breakdown by LLM" - "Compare brand perception across AI sources" - "Which AI model sees Nike as most comfortable?" - "Is brand perception consistent across different LLMs?" - "Get source-specific cluster distribution" **Returns:** Array of objects with brand, source, cluster, and share percentages. Example: [{"brand": "Nike", "source": "chatgpt-4", "cluster": "Comfortable", "share": "0.70"}, {"brand": "Nike", "source": "gemini", "cluster": "Comfortable", "share": "0.10"}] Required permission: `read:analysis`.

GET

organizations

{organization_id}

workspaces

{workspace_id}

analyses

{analysis_id}

metrics

brand_perception

brand_cluster_share_by_source

Brand Perception by LLM Source

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

import requests

url = "https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/metrics/brand_perception/brand_cluster_share_by_source"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/metrics/brand_perception/brand_cluster_share_by_source', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/metrics/brand_perception/brand_cluster_share_by_source",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/metrics/brand_perception/brand_cluster_share_by_source"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/metrics/brand_perception/brand_cluster_share_by_source")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/metrics/brand_perception/brand_cluster_share_by_source")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "brand": "Nike",
    "source": "chatgpt-3.5",
    "cluster": "Comfortable",
    "share": "0.3000"
  },
  {
    "brand": "Nike",
    "source": "chatgpt-3.5",
    "cluster": "Durable",
    "share": "0.2000"
  },
  {
    "brand": "Nike",
    "source": "chatgpt-3.5",
    "cluster": "Stylish",
    "share": "0.5000"
  },
  {
    "brand": "Nike",
    "source": "chatgpt-4",
    "cluster": "Comfortable",
    "share": "0.7000"
  },
  {
    "brand": "Nike",
    "source": "chatgpt-4",
    "cluster": "Durable",
    "share": "0.2000"
  },
  {
    "brand": "Nike",
    "source": "chatgpt-4",
    "cluster": "Stylish",
    "share": "0.1000"
  },
  {
    "brand": "Nike",
    "source": "gemini",
    "cluster": "Comfortable",
    "share": "0.1000"
  },
  {
    "brand": "Nike",
    "source": "gemini",
    "cluster": "Durable",
    "share": "0.7600"
  },
  {
    "brand": "Nike",
    "source": "gemini",
    "cluster": "Stylish",
    "share": "0.1400"
  }
]

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. Matching ignores case.

cluster_group

enum<string>

required

Filter by one specific cluster group.

Available options:

all_cons,

all_pros

collection_date

string<date>

Filter by a collection date being equal to the specified date. YYYY-MM-DD format

collection_date__gt

string<date>

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

collection_date__gte

string<date>

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

collection_date__lt

string<date>

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

collection_date__lte

string<date>

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

country

string

Filter by one specific country.

country__in

string

Filter by a list of countries. Values should be comma separated, without brackets or spaces

format

enum<string>

Available options:

csv,

json

persona

string

Filter by one specific persona.

persona__in

string

Filter by a list of personas. Values should be comma separated, without brackets or spaces

persona_ids

string

Filter by a list of persona IDs. Values should be comma separated, without brackets or spaces. The IDs are resolved to the persona labels recorded on the analysis, so this returns the same rows as the equivalent persona__in call. Use it for analyses that carry persona_ids; analyses predating persona records have none, and must be filtered with persona or persona__in. An ID that is not one of the analysis's personas matches no rows.

source

enum<string>

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,

deepseek-v3.2-maas,

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,

gemini-3.5-flash-lite,

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,

muse-spark-1.2,

muse-spark-1.3,

perplexity-sonar,

rufus

source__in

enum<string>

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,

deepseek-v3.2-maas,

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,

gemini-3.5-flash-lite,

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,

muse-spark-1.2,

muse-spark-1.3,

perplexity-sonar,

rufus

translate_to_en

boolean

If true, translates clusters and attributes to English. Defaults to false.

Response

brand

string

required

source

enum<string>

required

Available options:

gpt-3.5-turbo,

gpt-4-turbo,

gpt-4o,

gpt-4o-mini-search,

gpt-5,

gpt-5.2,

gpt-5.4-mini,

gemini-1.5-pro,

gemini-2.0-flash,

gemini-2.5-flash-grounded,

gemini-2.5-flash,

gemini-2.5-flash-lite,

gemini-3-flash-preview,

gemini-3.5-flash-lite,

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,

muse-spark-1.2,

muse-spark-1.3,

mistral-7B-instruct,

claude-3-5-sonnet,

claude-4-sonnet,

claude-4-5-sonnet,

claude-4-6-sonnet,

deepseek-chat,

deepseek-reasoner,

deepseek-v3.2-maas,

perplexity-sonar,

rufus,

google-ai-mode

cluster

string

required

Brand Perception by LLM Source

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

import requests

url = "https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/metrics/brand_perception/brand_cluster_share_by_source"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/metrics/brand_perception/brand_cluster_share_by_source', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/metrics/brand_perception/brand_cluster_share_by_source",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/metrics/brand_perception/brand_cluster_share_by_source"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/metrics/brand_perception/brand_cluster_share_by_source")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/analyses/{analysis_id}/metrics/brand_perception/brand_cluster_share_by_source")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "brand": "Nike",
    "source": "chatgpt-3.5",
    "cluster": "Comfortable",
    "share": "0.3000"
  },
  {
    "brand": "Nike",
    "source": "chatgpt-3.5",
    "cluster": "Durable",
    "share": "0.2000"
  },
  {
    "brand": "Nike",
    "source": "chatgpt-3.5",
    "cluster": "Stylish",
    "share": "0.5000"
  },
  {
    "brand": "Nike",
    "source": "chatgpt-4",
    "cluster": "Comfortable",
    "share": "0.7000"
  },
  {
    "brand": "Nike",
    "source": "chatgpt-4",
    "cluster": "Durable",
    "share": "0.2000"
  },
  {
    "brand": "Nike",
    "source": "chatgpt-4",
    "cluster": "Stylish",
    "share": "0.1000"
  },
  {
    "brand": "Nike",
    "source": "gemini",
    "cluster": "Comfortable",
    "share": "0.1000"
  },
  {
    "brand": "Nike",
    "source": "gemini",
    "cluster": "Durable",
    "share": "0.7600"
  },
  {
    "brand": "Nike",
    "source": "gemini",
    "cluster": "Stylish",
    "share": "0.1400"
  }
]

Overview

Core API

Search API

Brand Perception by LLM Source

Authorizations

Path Parameters

Query Parameters

Response