Brand Monitor Analyses — List, Retrieve, Delete

The analyses endpoints let you retrieve and manage the brand analyses stored in your CogNerd account. Use these endpoints to fetch historical results for your dashboard, build integrations that display visibility trends, or clean up analyses you no longer need. All endpoints require authentication and return standard JSON responses.

List all analyses

Retrieves all past brand analyses for your authenticated account, ordered by most recent first.

Endpoint

GET https://api.cognerd.in/api/brand-monitor/analyses

Request headers

Authorization

string

required

Your API token in the format Bearer YOUR_TOKEN.

Response

analyses

array

Array of analysis summary objects.

Show analysis summary fields

analyses[].id

string

Unique analysis identifier. Use this to fetch the full result or delete the analysis.

analyses[].brandName

string

The brand name that was analyzed.

analyses[].brandUrl

string

The brand URL that was analyzed, if one was provided.

analyses[].createdAt

string

ISO 8601 timestamp of when the analysis was created.

analyses[].visibilityScore

number

Overall AI visibility score from this analysis (0–100).

analyses[].status

string

Analysis status. One of completed, interrupted, or failed.

Code examples

curl --request GET \
  --url https://api.cognerd.in/api/brand-monitor/analyses \
  --header 'Authorization: Bearer YOUR_TOKEN'

const response = await fetch('https://api.cognerd.in/api/brand-monitor/analyses', {
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN'
  }
});

const { analyses } = await response.json();
console.log(analyses);

Example response

{
  "analyses": [
    {
      "id": "ana_01j9z4k8m3f7c2x1v5b9n6p0q",
      "brandName": "Acme Corp",
      "brandUrl": "https://acmecorp.com",
      "createdAt": "2026-04-27T10:01:10.000Z",
      "visibilityScore": 67,
      "status": "completed"
    },
    {
      "id": "ana_01j9y2h5k8d4b3w7r1m9n4p2t",
      "brandName": "Acme Corp",
      "brandUrl": "https://acmecorp.com",
      "createdAt": "2026-04-20T09:15:42.000Z",
      "visibilityScore": 61,
      "status": "completed"
    }
  ]
}

Get a single analysis

Retrieves the full analysis result for a specific analysis ID, including all visibility metrics, competitor data, platform breakdown, alerts, sources, and prompt analytics.

Endpoint

GET https://api.cognerd.in/api/brand-monitor/analyses/:id

Path parameters

string

required

The unique identifier of the analysis to retrieve. Obtain this from the list analyses endpoint or from a previous POST /analyze result.

Request headers

Authorization

string

required

Your API token in the format Bearer YOUR_TOKEN.

Response

The response contains the full analysis result object. The structure matches the data payload emitted in the final result SSE event from the POST /analyze endpoint.

string

Unique analysis identifier.

brandName

string

The brand name analyzed.

brandUrl

string

The brand URL analyzed, if provided.

createdAt

string

ISO 8601 timestamp of when the analysis was created.

overview

object

High-level mention and score summary.

Show overview fields

overview.mentions

object

Show mention fields

overview.mentions.total

number

Total brand mention count across all prompts and providers.

overview.mentions.explicit

number

Explicit brand mention count.

overview.mentions.implicit

number

Implicit brand reference count.

overview.citations

object

Show citation fields

overview.citations.total

number

Total source citation count.

overview.scores

object

Show score fields

overview.scores.visibilityScore

number

Overall AI visibility score (0–100).

overview.scores.averagePosition

number

Average position at which your brand appeared in AI answers.

overview.opportunities

number

Number of prompts where a competitor appeared and your brand did not.

visibility

object

Visibility metrics broken down by platform and time.

Show visibility fields

visibility.score

number

Overall AI visibility score (0–100).

visibility.dailyTrend

array

Array of {date, score} objects for trend charting.

visibility.platformBreakdown

array

Per-platform breakdown. Each object includes platform, score, mentions, citations, sentiment, and change.

competitors

object

Competitor ranking data.

Show competitors fields

competitors.competitors

array

Ranked list of competitors, including your own brand (isOwn: true). Each object includes name, visibility, mentions, shareOfVoice, avgPos, and isOwn.

alerts

object

Auto-generated alerts from this analysis run.

Show alerts fields

alerts.alerts

array

List of alert objects. Each includes id, type, title, description, and time. Alert types: visibility_drop, visibility_spike, new_mention, competitor, sentiment.

sources

object

Source attribution mapping AI citations to specific pages.

Show sources fields

sources.sources

array

List of source objects. Each includes domain, urls, mentions, and citations.

prompts

object

Per-prompt analytics.

Show prompts fields

prompts.prompts

array

List of prompt analytics objects. Each includes prompt, visibility, avgPosition, and trending.

interruptedRun

boolean

true if this analysis was interrupted before it completed. Partial results may be present.

Code examples

curl --request GET \
  --url https://api.cognerd.in/api/brand-monitor/analyses/ana_01j9z4k8m3f7c2x1v5b9n6p0q \
  --header 'Authorization: Bearer YOUR_TOKEN'

const id = 'ana_01j9z4k8m3f7c2x1v5b9n6p0q';

const response = await fetch(
  `https://api.cognerd.in/api/brand-monitor/analyses/${id}`,
  {
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const analysis = await response.json();
console.log('Visibility score:', analysis.visibility.score);
console.log('Platform breakdown:', analysis.visibility.platformBreakdown);

Example response

{
  "id": "ana_01j9z4k8m3f7c2x1v5b9n6p0q",
  "brandName": "Acme Corp",
  "brandUrl": "https://acmecorp.com",
  "createdAt": "2026-04-27T10:01:10.000Z",
  "overview": {
    "mentions": { "total": 12, "explicit": 9, "implicit": 3 },
    "citations": { "total": 5 },
    "scores": { "visibilityScore": 67, "averagePosition": 2.3 },
    "opportunities": 4
  },
  "visibility": {
    "score": 67,
    "dailyTrend": [
      { "date": "2026-04-27", "score": 67 }
    ],
    "platformBreakdown": [
      {
        "platform": "ChatGPT",
        "score": 72,
        "mentions": 5,
        "citations": 3,
        "sentiment": "positive",
        "change": 4
      },
      {
        "platform": "Gemini",
        "score": 61,
        "mentions": 4,
        "citations": 2,
        "sentiment": "neutral",
        "change": -1
      }
    ]
  },
  "competitors": {
    "competitors": [
      {
        "name": "Acme Corp",
        "visibility": 67,
        "mentions": 12,
        "shareOfVoice": 38,
        "avgPos": 2.3,
        "isOwn": true
      },
      {
        "name": "Rival Co",
        "visibility": 74,
        "mentions": 15,
        "shareOfVoice": 47,
        "avgPos": 1.8,
        "isOwn": false
      }
    ]
  },
  "alerts": {
    "alerts": [
      {
        "id": "alert-1",
        "type": "visibility_spike",
        "title": "Visibility spike on ChatGPT",
        "description": "Your visibility on ChatGPT increased by 4 points since the last analysis.",
        "time": "just now"
      }
    ]
  },
  "sources": {
    "sources": [
      {
        "domain": "acmecorp.com",
        "urls": ["https://acmecorp.com/features", "https://acmecorp.com/pricing"],
        "mentions": 8,
        "citations": 3
      }
    ]
  },
  "prompts": {
    "prompts": [
      {
        "prompt": "What are the best project management tools for remote teams?",
        "visibility": 72,
        "avgPosition": 2,
        "trending": true
      }
    ]
  },
  "interruptedRun": false
}

Error responses

Status	Meaning
`401`	Missing or invalid `Authorization` header.
`404`	No analysis with the given ID exists, or it belongs to a different account.

Delete an analysis

Permanently deletes an analysis from your account. This action cannot be undone.

Endpoint

DELETE https://api.cognerd.in/api/brand-monitor/analyses/:id

Path parameters

string

required

The unique identifier of the analysis to delete.

Request headers

Authorization

string

required

Your API token in the format Bearer YOUR_TOKEN.

Response

success

boolean

true when the analysis was successfully deleted.

string

The ID of the deleted analysis.

Code examples

curl --request DELETE \
  --url https://api.cognerd.in/api/brand-monitor/analyses/ana_01j9z4k8m3f7c2x1v5b9n6p0q \
  --header 'Authorization: Bearer YOUR_TOKEN'

const id = 'ana_01j9z4k8m3f7c2x1v5b9n6p0q';

const response = await fetch(
  `https://api.cognerd.in/api/brand-monitor/analyses/${id}`,
  {
    method: 'DELETE',
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const result = await response.json();
console.log(result.success); // true

Example response

{
  "success": true,
  "id": "ana_01j9z4k8m3f7c2x1v5b9n6p0q"
}

Error responses

Status	Meaning
`401`	Missing or invalid `Authorization` header.
`404`	No analysis with the given ID exists, or it belongs to a different account.

​List all analyses

​Endpoint

​Request headers

​Response

​Code examples

​Example response

​Get a single analysis

​Endpoint

​Path parameters

​Request headers

​Response

​Code examples

​Example response

​Error responses

​Delete an analysis

​Endpoint

​Path parameters

​Request headers

​Response

​Code examples

​Example response

​Error responses

List all analyses

Endpoint

Request headers

Response

Code examples

Example response

Get a single analysis

Endpoint

Path parameters

Request headers

Response

Code examples

Example response

Error responses

Delete an analysis

Endpoint

Path parameters

Request headers

Response

Code examples

Example response

Error responses