---
name: "visibility_report"
area: "visibility"
title: "Get the AI visibility report"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/visibility_report"
mcp_server: "https://api.conecto.chat/mcp/visibility"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/visibility/visibility_report"
---

# Get the AI visibility report (`visibility_report`)

The latest check: how often the business is named, its trend, each assistant, its rank against the competitors, the sites cited, and the next actions.

The latest check: overall visibility (share of answers naming the business), its trend, each assistant, rank against the competitors, the sites the assistants cite, and the next actions. Free.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

Someone asks how visible the business is in AI answers.

## Say this to your agent

> How often do the AI assistants mention us now, compared with the last check?

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `website` | string | yes | The business website, e.g. https://acme.com (4 to 500 characters) |  |  |

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `visibility_report` on the MCP server `https://api.conecto.chat/mcp/visibility` with these arguments:

```json
{
  "website": "https://halversoncycle.example"
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/visibility_report \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"website": "https://halversoncycle.example"}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "visibility_report",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "brand": "Halverson Cycle & Repair",
    "website": "https://halversoncycle.example",
    "checked_at": "2026-10-14T08:12:40+00:00",
    "visibility": 0.29,
    "previous": 0.21,
    "trend": [
      {
        "at": "2026-09-14T08:10:02+00:00",
        "visibility": 0.21
      },
      {
        "at": "2026-10-14T08:12:40+00:00",
        "visibility": 0.29
      }
    ],
    "assistants": [
      {
        "name": "ChatGPT",
        "logo": "openai",
        "visibility": 0.5
      },
      {
        "name": "Perplexity",
        "logo": "perplexity-color",
        "visibility": 0.33
      }
    ],
    "brands": [
      {
        "name": "REI",
        "you": false,
        "visibility": 0.64
      },
      {
        "name": "Halverson Cycle & Repair",
        "you": true,
        "visibility": 0.29
      }
    ],
    "rank": 2,
    "sources": [
      {
        "domain": "bikeportland.org",
        "answers": 6
      },
      {
        "domain": "oregonlive.com",
        "answers": 4
      }
    ],
    "answers": 14,
    "actions": [
      {
        "title": "Get mentioned on bikeportland.org",
        "category": "earned",
        "impact": "high",
        "why": "bikeportland.org is cited in 6 of 14 answers, and names REI and Trek but not Halverson Cycle & Repair.",
        "steps": [
          "Send the editors the shop's address, opening hours and what the workshop does best.",
          "Offer a free winter tune-up clinic the site can write about."
        ],
        "domain": "bikeportland.org",
        "competitors": [
          "REI",
          "Trek"
        ],
        "id": "4be1c0a97d23"
      }
    ]
  }
}
```

`result`: The brand, website and when it was checked, visibility (the share of answers naming the business) and the previous one, the trend, each assistant, the brands with their visibility and the business's rank, the sites cited most, how many answers, and the actions.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `not_found` | 404 | The website is not set up for tracking yet. | Call visibility_setup first. |
| `invalid_input` | 400 | No business website was given. | Send it like https://halversoncycle.example. |

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [visibility_setup](https://conecto.chat/tools/visibility/visibility_setup.md): Chooses what to track for a website: the buyer questions, the competitors and the assistants to ask. $0.001 a call.
- [visibility_check](https://conecto.chat/tools/visibility/visibility_check.md): Asks every tracked question on each chosen assistant, with web search on, and measures how often and how well the business is named. $0.04 per answer (one question on one assistant).
- [visibility_answers](https://conecto.chat/tools/visibility/visibility_answers.md): The answers behind the latest check, page by page, optionally only the ones that named the business or only the ones that did not. Free up to 1,000,000 reads a month.
- [visibility_improve](https://conecto.chat/tools/visibility/visibility_improve.md): What to do to be named more often: the actions from the latest check, highest impact first, with concrete steps. Free up to 1,000,000 reads a month.