---
name: "visibility_check"
area: "visibility"
title: "Run an AI visibility check"
price: "$0.04 per answer (one question on one assistant)"
method: "POST"
url: "https://api.conecto.chat/v1/tools/visibility_check"
mcp_server: "https://api.conecto.chat/mcp/visibility"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/visibility/visibility_check"
---

# Run an AI visibility check (`visibility_check`)

Asks every tracked question on each chosen assistant, with web search on, and measures how often and how well the business is named.

Ask every tracked buyer question on each chosen assistant, with web search on, and measure how often the business is named, where, how favourably, against which competitors, and which sites the assistants cite. Takes a few minutes. When it finishes, the result is the same report as visibility_report.

Price: $0.04 per answer (one question on one assistant). A call that fails costs nothing.

## Use it when

The tracking is set up and fresh numbers are wanted (a check takes a few minutes).

## Say this to your agent

> Run the AI visibility check now and tell me how we compare.

## 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_check` 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_check \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"website": "https://halversoncycle.example"}'
```

## Response

This tool runs in the background. The first reply has status `202`:

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "visibility_check",
  "status": "running",
  "reserved_usd": "$2.80",
  "poll": "GET /v1/calls/5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93 (or the account_get_call tool) until status is succeeded or failed. You are charged only when it succeeds."
}
```

Poll `GET https://api.conecto.chat/v1/calls/<call_id>` (or call `account_get_call`) until `status` is `succeeded` or `failed`. When it succeeds, `output` holds the result:

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "visibility_check",
  "area": "visibility",
  "status": "succeeded",
  "cost_usd": "$2.80",
  "error": null,
  "message": null,
  "latency_ms": 4210,
  "at": "2026-10-14T08:00:00+00:00",
  "bot": "Pip",
  "person": null,
  "input": {
    "website": "https://halversoncycle.example"
  },
  "output": {
    "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"
      }
    ]
  }
}
```

`output`: When it finishes: the same report as visibility_report.

## 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. |
| `check_failed` | 502 | The assistants could not be asked; the message says why. | Try again later; nothing was charged. |

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_report](https://conecto.chat/tools/visibility/visibility_report.md): 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. Free up to 1,000,000 reads a month.
- [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.