# Overview

> Read your Gensiv workspace data from your own scripts, dashboards and agents with the Gensiv REST API.

The Gensiv API returns your AI visibility data as JSON over HTTPS: brands, prompts, AI answers, visibility against competitors, citations, Reddit threads, content gaps and more. The base URL is `https://app.gensiv.com/api/v1`.

Every key can read. Keys created with **Allow changes** can also add, edit and delete prompts, competitors, topics, tags, personas and actions, and start articles. The API is available on Starter and up.

## Quick start

1. Create a key in **Settings > API keys**. See [Authentication](/docs/api/authentication).
2. List your brands:

```bash
curl https://app.gensiv.com/api/v1/brands \
  -H "x-api-key: $GENSIV_API_KEY"
```

3. Pass a brand `id` from the response to any other endpoint, for example [List responses](/docs/api/responses/list-responses): `GET /brands/{brandId}/responses`.

Every endpoint page has a **Try it** panel. Paste your key there to send a live request and see the real response.

## What you can read

| Group                                                      | What you get                                                                    |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------- |
| [Brands](/docs/api/brands/list-brands)                     | Your brands, the brand hub and the AI engines each brand tracks                 |
| [Visibility](/docs/api/visibility/get-visibility-overview) | Visibility, share of voice and position against competitors, by engine and day  |
| [Prompts](/docs/api/prompts/list-prompts)                  | Tracked prompts and how each one performs                                       |
| [Responses](/docs/api/responses/list-responses)            | The answers AI engines gave, with every brand mention and citation              |
| [Citations](/docs/api/citations/list-cited-domains)        | The domains and pages AI engines cite                                           |
| [Reddit](/docs/api/reddit/list-reddit-posts)               | Reddit posts AI engines cite                                                    |
| [Content gaps](/docs/api/content-gaps/list-content-gaps)   | How well your site covers what AI answers discuss                               |
| [Usage](/docs/api/usage/get-usage)                         | Plan limits and what the workspace used this period                             |

The OpenAPI spec is at `https://app.gensiv.com/api/v1/public/openapi.json` if you want to generate a client.

For AI assistants, the [MCP server](/docs/mcp) returns the same data as tools.

---

Source: https://gensiv.com/docs/api