# Cognizo Docs

> Cognizo API and MCP Documentation. Track and grow your brand's visibility, share of voice, and sentiment across AI search engines like ChatGPT, Claude, Perplexity, and Google AI Overviews.

- [Cognizo API](https://docs.cognizo.ai/index.md): Track and grow your brand's visibility across AI search — programmatically.
- [Quickstart](https://docs.cognizo.ai/quickstart.md): From zero to your first API call.
- [Authentication](https://docs.cognizo.ai/guides/authentication.md): API keys and the X-API-KEY header.
- [Pagination & filtering](https://docs.cognizo.ai/guides/pagination-filtering.md): Page, sort, and filter list endpoints consistently.
- [Metrics & units](https://docs.cognizo.ai/guides/metrics.md): What visibility, share of voice and sentiment actually measure — and the units traps.
- [Errors](https://docs.cognizo.ai/guides/errors.md): The error envelope, the codes you can get, and how to handle them.
- [Rate limits](https://docs.cognizo.ai/guides/rate-limits.md): Limits, the 429 response, and how to back off.
- [API Reference](https://docs.cognizo.ai/api-reference/introduction.md): Base URL, auth, response envelope, and the full endpoint list.
- [List brands](https://docs.cognizo.ai/api-reference/brands/list-brands.md)
- [Create (or reactivate) a brand](https://docs.cognizo.ai/api-reference/brands/create-or-reactivate-a-brand.md)
- [Get a brand](https://docs.cognizo.ai/api-reference/brands/get-a-brand.md)
- [Soft-delete a brand](https://docs.cognizo.ai/api-reference/brands/soft-delete-a-brand.md)
- [Update a brand](https://docs.cognizo.ai/api-reference/brands/update-a-brand.md): Only fields sent with a value are applied. Sending an empty string leaves that field unchanged rather than clearing it, so a description or category cannot be blanked through the API.
- [Brand-level visibility (aggregate + time series)](https://docs.cognizo.ai/api-reference/metrics/brand-level-visibility-aggregate-+-time-series.md)
- [Brand-level share of voice (aggregate + time series)](https://docs.cognizo.ai/api-reference/metrics/brand-level-share-of-voice-aggregate-+-time-series.md)
- [Brand-level sentiment (aggregate + time series)](https://docs.cognizo.ai/api-reference/metrics/brand-level-sentiment-aggregate-+-time-series.md)
- [List a brand's topics with their metrics and prompt counts](https://docs.cognizo.ai/api-reference/topics/list-a-brands-topics-with-their-metrics-and-prompt-counts.md)
- [Bulk-create topics (reactivates soft-deleted names)](https://docs.cognizo.ai/api-reference/topics/bulk-create-topics-reactivates-soft-deleted-names.md)
- [Get one topic with extended metrics](https://docs.cognizo.ai/api-reference/topics/get-one-topic-with-extended-metrics.md)
- [Soft-delete a topic and deactivate its prompts](https://docs.cognizo.ai/api-reference/topics/soft-delete-a-topic-and-deactivate-its-prompts.md)
- [Rename / soft-delete a topic](https://docs.cognizo.ai/api-reference/topics/rename-soft-delete-a-topic.md)
- [List a brand's prompts with their metrics](https://docs.cognizo.ai/api-reference/prompts/list-a-brands-prompts-with-their-metrics.md)
- [Bulk-add prompts to a brand](https://docs.cognizo.ai/api-reference/prompts/bulk-add-prompts-to-a-brand.md): Validates and creates prompts under their topics (one prompt variety per subscription provider). A prompt the brand already tracks in that region is rejected — under any topic, and matched case-insensitively, so a casing variant of a tracked prompt is a duplicate too. A prompt the brand DEACTIVATED…
- [Bulk-edit prompts (move topic / soft delete / reactivate)](https://docs.cognizo.ai/api-reference/prompts/bulk-edit-prompts-move-topic-soft-delete-reactivate.md): Each update targets a (prompt_id, region_id) pair across all its provider varieties. Reactivations are limit-enforced (422 rolls back). Response data aligns with the request order: [{index, success}].
- [Get a single prompt's metrics row](https://docs.cognizo.ai/api-reference/prompts/get-a-single-prompts-metrics-row.md): Same computation as the prompts list, for one (prompt_id, region_id) pair.
- [Prompt-level visibility (aggregate + time series)](https://docs.cognizo.ai/api-reference/prompts/prompt-level-visibility-aggregate-+-time-series.md)
- [Prompt-level share of voice (aggregate + time series)](https://docs.cognizo.ai/api-reference/prompts/prompt-level-share-of-voice-aggregate-+-time-series.md)
- [Prompt-level sentiment (aggregate + time series)](https://docs.cognizo.ai/api-reference/prompts/prompt-level-sentiment-aggregate-+-time-series.md)
- [Most-cited domains](https://docs.cognizo.ai/api-reference/citations/most-cited-domains.md)
- [Domain-level share overview (citation/mention series + type breakdown)](https://docs.cognizo.ai/api-reference/citations/domain-level-share-overview-citationmention-series-+-type-breakdown.md)
- [Most-cited pages](https://docs.cognizo.ai/api-reference/citations/most-cited-pages.md)
- [Page-level share overview (citation/mention series + page-type breakdown)](https://docs.cognizo.ai/api-reference/citations/page-level-share-overview-citationmention-series-+-page-type-breakdown.md)
- [Citations overview (summary stats, distributions, top growing)](https://docs.cognizo.ai/api-reference/citations/citations-overview-summary-stats-distributions-top-growing.md)
- [Citation summary by domain type](https://docs.cognizo.ai/api-reference/citations/citation-summary-by-domain-type.md)
- [Owned-citation share time series](https://docs.cognizo.ai/api-reference/citations/owned-citation-share-time-series.md)
- [Brand-mention share time series](https://docs.cognizo.ai/api-reference/citations/brand-mention-share-time-series.md)
- [List tracked competitors](https://docs.cognizo.ai/api-reference/competitors/list-tracked-competitors.md)
- [Track a competitor directly](https://docs.cognizo.ai/api-reference/competitors/track-a-competitor-directly.md)
- [Untrack a competitor](https://docs.cognizo.ai/api-reference/competitors/untrack-a-competitor.md)
- [Update a tracked competitor's domain](https://docs.cognizo.ai/api-reference/competitors/update-a-tracked-competitors-domain.md)
- [List ads (distinct creatives) running on a brand's prompts](https://docs.cognizo.ai/api-reference/ads/list-ads-distinct-creatives-running-on-a-brands-prompts.md)
- [Ad-visibility breakdown by dimension](https://docs.cognizo.ai/api-reference/ads/ad-visibility-breakdown-by-dimension.md)
- [Single ad detail (with copy)](https://docs.cognizo.ai/api-reference/ads/single-ad-detail-with-copy.md)
- [List advertisers running ads on a brand's prompts](https://docs.cognizo.ai/api-reference/advertisers/list-advertisers-running-ads-on-a-brands-prompts.md)
- [Advertiser summary](https://docs.cognizo.ai/api-reference/advertisers/advertiser-summary.md)
- [Ads an advertiser ran](https://docs.cognizo.ai/api-reference/advertisers/ads-an-advertiser-ran.md)
- [List available regions with their ids and country codes](https://docs.cognizo.ai/api-reference/filters/list-available-regions-with-their-ids-and-country-codes.md)
- [List content recommendations](https://docs.cognizo.ai/api-reference/contentstudio/list-content-recommendations.md)
- [List content briefs](https://docs.cognizo.ai/api-reference/contentstudio/list-content-briefs.md)
- [Create a custom brief (triggers async brief generation)](https://docs.cognizo.ai/api-reference/contentstudio/create-a-custom-brief-triggers-async-brief-generation.md)
- [Show one brief](https://docs.cognizo.ai/api-reference/contentstudio/show-one-brief.md)
- [Soft-delete a brief](https://docs.cognizo.ai/api-reference/contentstudio/soft-delete-a-brief.md)
- [Rename a content brief](https://docs.cognizo.ai/api-reference/contentstudio/rename-a-content-brief.md)
- [Trigger async article generation from the finalized brief](https://docs.cognizo.ai/api-reference/contentstudio/trigger-async-article-generation-from-the-finalized-brief.md)
- [Show one article](https://docs.cognizo.ai/api-reference/contentstudio/show-one-article.md)
- [Update an article's content](https://docs.cognizo.ai/api-reference/contentstudio/update-an-articles-content.md)
- [Soft-delete an article](https://docs.cognizo.ai/api-reference/contentstudio/soft-delete-an-article.md)
- [List opportunities for a brand (filterable, paginated, sortable)](https://docs.cognizo.ai/api-reference/opportunities/list-opportunities-for-a-brand-filterable-paginated-sortable.md)
- [Detail payload for a single opportunity](https://docs.cognizo.ai/api-reference/opportunities/detail-payload-for-a-single-opportunity.md)
- [Replace the opportunity's strategy-list memberships (multi-list)](https://docs.cognizo.ai/api-reference/opportunities/replace-the-opportunitys-strategy-list-memberships-multi-list.md)
- [Current compute-worker state + daily quota snapshot](https://docs.cognizo.ai/api-reference/opportunities/current-compute-worker-state-+-daily-quota-snapshot.md)
- [Enqueue a per-brand opportunity recompute](https://docs.cognizo.ai/api-reference/opportunities/enqueue-a-per-brand-opportunity-recompute.md)
- [List the brand's strategy lists](https://docs.cognizo.ai/api-reference/opportunity-lists/list-the-brands-strategy-lists.md)
- [Create a new strategy list](https://docs.cognizo.ai/api-reference/opportunity-lists/create-a-new-strategy-list.md)
- [Delete a strategy list](https://docs.cognizo.ai/api-reference/opportunity-lists/delete-a-strategy-list.md)
- [Rename / recolor / reorder a strategy list](https://docs.cognizo.ai/api-reference/opportunity-lists/rename-recolor-reorder-a-strategy-list.md)
- [MCP Server](https://docs.cognizo.ai/mcp/overview.md): What the Cognizo MCP server is, and how it fits with the API.
- [Connect a client](https://docs.cognizo.ai/mcp/setup.md): Connect Claude, Cursor, VS Code, Windsurf or ChatGPT to the Cognizo MCP server.
- [Tools](https://docs.cognizo.ai/mcp/tools.md): All 62 tools the Cognizo MCP server exposes.
- [Security & troubleshooting](https://docs.cognizo.ai/mcp/troubleshooting.md): How your credentials are handled, and what to do when a tool call fails.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.