Skip to main content
The Cognizo API gives you programmatic access to your brand’s AI-search data: visibility, share of voice, sentiment, prompts, citations, competitors and ads. Everything the Cognizo app shows, you can pull into your own tools, dashboards, and agents.

Quickstart

Create an API key and make your first request in a couple of minutes.

API Reference

All 38 operations, with an interactive “try it” console.

Metrics & units

What visibility, share_of_voice and sentiment actually measure.

MCP Server

Connect Cognizo to Claude, Cursor, and other AI clients.

​
Base URL

All requests go to:

​
Authentication in one line

Send your API key in the X-API-KEY header:
See Authentication for how to create and manage keys.

​
Response shape

Every response uses one envelope:
data is the resource or list; meta carries pagination and operation metadata. Errors return an error object instead — never alongside data:
Branch on error.code, not on the message. The full list is in Errors.

​
What’s in the API

Brands & topics

List, create, update and soft-delete brands; manage the topics your prompts hang off.

Prompts

Bulk-add prompts, list them with per-prompt metrics, and drill into a single prompt in one region.

Citations

Most-cited domains and pages, ownership share, and mention share over time.

Competitors & ads

Tracked competitors, plus the advertisers and creatives showing up on your prompts.
Conventions that hold everywhere: snake_case JSON keys, ISO 8601 timestamps, page/page_size pagination, and filter[…] query parameters — see Pagination & filtering.