> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/check_ai_visibility

# check_ai_visibility

> What ChatGPT answers to a prompt right now, from a chosen country, with the sources it cites and the brands it names. ₹0.37 per prompt; a failed extraction is ₹0.

## What it does

One live ChatGPT session for your prompt from a chosen country: the answer `text`, the `sources` it cited, `citationPills`, the brand `entities` it named and, when asked, shopping cards and ads, in `data.result`. Use it to see whether and how a brand or product shows up in AI answers ("best CRM for small business in India"). Answers vary between runs, so run a prompt two or three times before concluding a brand is absent. It does not search the web for you ([`search_web`](https://parel.si/docs/tools/search_web.md)) and does not cover Google's AI Overview.

India: `country: "IN"` (uppercase ISO code). Refused countries: CN, CZ, HK, IR, MO, RU, VE.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `state` | string | no | US state code for state-level targeting ("CA"). Adds a surcharge to the call. |
| `legacy` | boolean | no | serve the desktop UI, where ads and shopping render; free. Defaults to the mobile-web UI. |
| `prompt` | string | yes | 1-10,000 characters. e.g. "best running shoes for flat feet" |
| `country` | string | yes | ISO 3166-1 alpha-2. CN, CZ, HK, IR, MO, RU and VE are refused.. e.g. "US" |
| `include` | object | no | Extra parts to return, as an object with any of markdown, html, rawResponse, searchQueries, ads, shopping set to true. markdown and html are free; any of the other four adds one surcharge to the call, however many are set. |
| `disableWebSearch` | boolean | no | answer from the model alone, without a web search |

## What drives the cost

The base price covers the answer, sources and entities. `include.markdown` and `include.html` are free. Setting any of `include.rawResponse`, `include.searchQueries`, `include.ads` or `include.shopping` adds one surcharge at the source however many of the four are set, and `state` (US state targeting) adds another; the quote for your exact input is [`POST /v1/quote`](https://parel.si/docs/api/quote.md). Slow: 20 to 40 seconds per call; the timeout allows 180.

## Price today

| | |
|---|---|
| Price today | **₹0.37** per prompt (`cost_paise: 37`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.56 (`hold_paise: 56`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 180 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | a headline tool: call `check_ai_visibility` directly |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "check_ai_visibility"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"check_ai_visibility","input":{"prompt":"best CRM for small businesses in India","country":"IN"}}'
```

Over MCP, `check_ai_visibility` is a headline tool: Claude calls it directly with `prompt`, `country` and the optional fields.

## What comes back

`data.result` with `model`, `text`, `sources[]` (`position`, `label`, `url`), `entities[]`, `citationPills[]`, and the optional blocks. A recorded answer from the source, trimmed:

```json
{
  "success": true,
  "result": {
    "model": "gpt-5-6",
    "text": "A stock split is when a company increases the number of its shares by dividing existing shares into smaller pieces, while keeping the overall value of the company the same. FINRA+1\nThink of it like cutting a pizza into more slices:\n\n\nBefore the split: You own 1 share worth $100\n\n\nThe company does a …",
    "sources": [
      {
        "position": 1,
        "label": "Stock Splits | FINRA.org",
        "url": "https://www.finra.org/investors/investing/investment-products/stocks/stock-splits?utm_source=chatgpt.com",
        "description": "",
        "footnote": false
      },
      {
        "position": 2,
        "label": "Stock Split | Investor.gov",
        "url": "https://www.investor.gov/introduction-investing/investing-basics/glossary/stock-split?utm_source=chatgpt.com",
        "description": "",
        "footnote": false
      },
      "… 1 more"
    ],
    "entities": [],
    "map": [],
    "citationPills": [
      {
        "url": "https://www.finra.org/investors/investing/investment-products/stocks/stock-splits?utm_source=chatgpt.com",
        "label": "Stock Splits | FINRA.org",
        "domain": "finra.org",
        "type": "groupedWebpage",
        "citationPillId": 0,
        "position": 1
      },
      {
        "url": "https://www.investor.gov/introduction-investing/investing-basics/glossary/stock-split?utm_source=chatgpt.com",
        "label": "Stock Split | Investor.gov",
        "domain": "investor.gov",
        "type": "groupedWebpage",
        "citationPillId": 0,
        "position": 2
      },
      "… 1 more"
    ],
    "shoppingCards": [],
    "inlineProducts": [],
    "ads": [],
    "searchQueries": [
      "what is a stock split definition"
    ],
    "mapSearchQueries": []
  }
}
```

## Notes

- Slow: 20 to 40 s per call; the timeout allows 90 s.
- Answers are not deterministic: run the same prompt two or three times before concluding a brand is absent.
- A failed extraction is free. Refused countries: CN, CZ, HK, IR, MO, RU, VE.
- India: country "IN".

## Siblings

- [`search_web`](https://parel.si/docs/tools/search_web.md) for Google's ranking of the same query.
- [`read_page`](https://parel.si/docs/tools/read_page.md) to read a source ChatGPT cited.
