# Cognizo

## Docs

- [Ad-visibility breakdown by dimension](https://docs.cognizo.ai/api-reference/ads/ad-visibility-breakdown-by-dimension.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)
- [Single ad detail (with copy)](https://docs.cognizo.ai/api-reference/ads/single-ad-detail-with-copy.md)
- [Ads an advertiser ran](https://docs.cognizo.ai/api-reference/advertisers/ads-an-advertiser-ran.md)
- [Advertiser summary](https://docs.cognizo.ai/api-reference/advertisers/advertiser-summary.md)
- [List advertisers running ads on a brand's prompts (filterable, paginated, sortable)](https://docs.cognizo.ai/api-reference/advertisers/list-advertisers-running-ads-on-a-brands-prompts-filterable-paginated-sortable.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)
- [List brands](https://docs.cognizo.ai/api-reference/brands/list-brands.md)
- [Partially update a brand (blank values keep old data)](https://docs.cognizo.ai/api-reference/brands/partially-update-a-brand-blank-values-keep-old-data.md)
- [Soft-delete a brand](https://docs.cognizo.ai/api-reference/brands/soft-delete-a-brand.md)
- [Brand-mention share time series](https://docs.cognizo.ai/api-reference/citations/brand-mention-share-time-series.md)
- [Citation summary by domain type](https://docs.cognizo.ai/api-reference/citations/citation-summary-by-domain-type.md)
- [Citations overview (summary stats, distributions, top growing)](https://docs.cognizo.ai/api-reference/citations/citations-overview-summary-stats-distributions-top-growing.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 domains](https://docs.cognizo.ai/api-reference/citations/most-cited-domains.md)
- [Most-cited pages](https://docs.cognizo.ai/api-reference/citations/most-cited-pages.md)
- [Owned-citation share time series](https://docs.cognizo.ai/api-reference/citations/owned-citation-share-time-series.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)
- [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)
- [API Reference](https://docs.cognizo.ai/api-reference/introduction.md): Base URL, auth, response envelope, and the full endpoint list.
- [Brand-level sentiment (aggregate + time series)](https://docs.cognizo.ai/api-reference/metrics/brand-level-sentiment-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 visibility (aggregate + time series)](https://docs.cognizo.ai/api-reference/metrics/brand-level-visibility-aggregate-+-time-series.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). Invalid rows are flagged in errors_and_warnings while the valid ones are written. Usage limits are enforced transactionally — a batch that would exceed them is rolled back entirely (422 USAGE_LIMIT_REACH…
- [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.
- [List a brand's prompts with their metrics](https://docs.cognizo.ai/api-reference/prompts/list-a-brands-prompts-with-their-metrics.md)
- [Prompt-level sentiment (aggregate + time series)](https://docs.cognizo.ai/api-reference/prompts/prompt-level-sentiment-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 visibility (aggregate + time series)](https://docs.cognizo.ai/api-reference/prompts/prompt-level-visibility-aggregate-+-time-series.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)
- [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)
- [Rename / soft-delete a topic](https://docs.cognizo.ai/api-reference/topics/rename-soft-delete-a-topic.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)
- [Authentication](https://docs.cognizo.ai/guides/authentication.md): API keys and the X-API-KEY header.
- [Errors](https://docs.cognizo.ai/guides/errors.md): The error envelope, the codes you can get, and how to handle them.
- [Metrics & units](https://docs.cognizo.ai/guides/metrics.md): What visibility, share of voice and sentiment actually measure — and the units traps.
- [Pagination & filtering](https://docs.cognizo.ai/guides/pagination-filtering.md): Page, sort, and filter list endpoints consistently.
- [Rate limits](https://docs.cognizo.ai/guides/rate-limits.md): Limits, the 429 response, and how to back off.
- [Cognizo API](https://docs.cognizo.ai/index.md): Track and grow your brand's visibility across AI search — programmatically.
- [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): Point Claude, Cursor, VS Code or Windsurf at the Cognizo MCP server.
- [Tools](https://docs.cognizo.ai/mcp/tools.md): All 42 tools the Cognizo MCP server exposes.
- [Security & troubleshooting](https://docs.cognizo.ai/mcp/troubleshooting.md): How your key is handled, and what to do when a tool call fails.
- [Quickstart](https://docs.cognizo.ai/quickstart.md): From zero to your first API call.

## OpenAPI Specs

- [openapi](https://docs.cognizo.ai/api-reference/openapi.json)