> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognizo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cognizo API

> Track and grow your brand's visibility across AI search — programmatically.

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.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Create an API key and make your first request in a couple of minutes.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    All 38 operations, with an interactive "try it" console.
  </Card>

  <Card title="Metrics & units" icon="ruler" href="/guides/metrics">
    What `visibility`, `share_of_voice` and `sentiment` actually measure.
  </Card>

  <Card title="MCP Server" icon="robot" href="/mcp/overview">
    Connect Cognizo to Claude, Cursor, and other AI clients.
  </Card>
</CardGroup>

## Base URL

All requests go to:

```
https://core.cognizo.ai
```

## Authentication in one line

Send your API key in the `X-API-KEY` header:

```bash theme={null}
curl https://core.cognizo.ai/api/v2/brands \
  -H "X-API-KEY: YOUR_API_KEY"
```

See [Authentication](/guides/authentication) for how to create and manage keys.

## Response shape

Every response uses one envelope:

```json theme={null}
{ "data": { }, "meta": { } }
```

`data` is the resource or list; `meta` carries pagination and operation
metadata. Errors return an `error` object instead — never alongside `data`:

```json theme={null}
{ "error": { "code": "NOT_FOUND", "message": "Brand not found" } }
```

Branch on `error.code`, not on the message. The full list is in
[Errors](/guides/errors).

## What's in the API

<CardGroup cols={2}>
  <Card title="Brands & topics" icon="building">
    List, create, update and soft-delete brands; manage the topics your
    prompts hang off.
  </Card>

  <Card title="Prompts" icon="message">
    Bulk-add prompts, list them with per-prompt metrics, and drill into a
    single prompt in one region.
  </Card>

  <Card title="Citations" icon="link">
    Most-cited domains and pages, ownership share, and mention share over
    time.
  </Card>

  <Card title="Competitors & ads" icon="chart-simple">
    Tracked competitors, plus the advertisers and creatives showing up on
    your prompts.
  </Card>
</CardGroup>

Conventions that hold everywhere: `snake_case` JSON keys, ISO 8601
timestamps, `page`/`page_size` pagination, and `filter[…]` query parameters —
see [Pagination & filtering](/guides/pagination-filtering).