Documentation Index Fetch the complete documentation index at: https://docs.cognerd.in/llms.txt
Use this file to discover all available pages before exploring further.
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
Your API token in the format Bearer YOUR_TOKEN.
Response Array of analysis summary objects. Show analysis summary fields
Unique analysis identifier. Use this to fetch the full result or delete the analysis.
The brand name that was analyzed.
The brand URL that was analyzed, if one was provided.
ISO 8601 timestamp of when the analysis was created.
analyses[].visibilityScore
Overall AI visibility score from this analysis (0–100).
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'
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 The unique identifier of the analysis to retrieve. Obtain this from the list analyses endpoint or from a previous POST /analyze result.
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
Unique analysis identifier.
The brand URL analyzed, if provided.
ISO 8601 timestamp of when the analysis was created.
High-level mention and score summary. Total brand mention count across all prompts and providers.
overview.mentions.explicit
Explicit brand mention count.
overview.mentions.implicit
Implicit brand reference count.
Total source citation count.
overview.scores.visibilityScore
Overall AI visibility score (0–100).
overview.scores.averagePosition
Average position at which your brand appeared in AI answers.
Number of prompts where a competitor appeared and your brand did not.
Visibility metrics broken down by platform and time. Overall AI visibility score (0–100).
Array of {date, score} objects for trend charting.
visibility.platformBreakdown
Per-platform breakdown. Each object includes platform, score, mentions, citations, sentiment, and change.
Competitor ranking data. Ranked list of competitors, including your own brand (isOwn: true). Each object includes name, visibility, mentions, shareOfVoice, avgPos, and isOwn.
Auto-generated alerts from this analysis run. List of alert objects. Each includes id, type, title, description, and time. Alert types: visibility_drop, visibility_spike, new_mention, competitor, sentiment.
Source attribution mapping AI citations to specific pages. List of source objects. Each includes domain, urls, mentions, and citations.
Per-prompt analytics. List of prompt analytics objects. Each includes prompt, visibility, avgPosition, and trending.
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'
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 401Missing or invalid Authorization header. 404No 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 The unique identifier of the analysis to delete.
Your API token in the format Bearer YOUR_TOKEN.
Response true when the analysis was successfully deleted.
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'
Example response { "success" : true , "id" : "ana_01j9z4k8m3f7c2x1v5b9n6p0q" }
Error responses Status Meaning 401Missing or invalid Authorization header. 404No analysis with the given ID exists, or it belongs to a different account.