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

# LLM Brand Mentions API

> How AI assistants answer your prompts and whether they mention your brand or competitors, with assistant, model, country and the full answer. Pass prompts, brand aliases, competitors and assistants.

`POST /v1/data/llm/brand-mentions/run`

**Pricing:** $0.006 per answer ($6.00 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**prompts** `string[]` *required*

One or more prompts. One request reads them all.

**brand** `string` *required*

Brand.

**brandAliases** `string[]`

One or more brand aliases. One request reads them all.

**brandWebsite** `string`

Brand Website.

Format e.g. `stripe.com`.

**competitors** `string[]`

One or more competitors. One request reads them all.

**assistants** `string[]` (default: \["chatgpt"])

Which AI assistants to ask: ChatGPT, Gemini, Google AI Mode, Google AI Overview. Each assistant gives one answer (one row) per prompt, so 3 prompts on 2 assistants is 6 answers. Defaults to ChatGPT.

Allowed values: `chatgpt` (ChatGPT), `gemini` (Gemini), `google_ai_mode` (Google AI Mode), `google_ai_overview` (Google AI Overview).

**country** `string` (default: US)

Country the prompts are asked from, e.g. United Kingdom. Defaults to United States.

249 allowed values, for example `AF` (Afghanistan), `AL` (Albania), `DZ` (Algeria), `AS` (American Samoa), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), `AQ` (Antarctica), `AG` (Antigua and Barbuda), `AR` (Argentina). Fetch the full list with `GET /v1/data/llm/brand-mentions?expand=options`.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/llm/brand-mentions/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "prompts": [
      "What are the best CRM tools for small businesses?",
      "Quels sont les meilleurs logiciels CRM pour les PME ?",
      "Who founded HubSpot and in what year?"
    ],
    "brand": "HubSpot",
    "brandWebsite": "hubspot.com",
    "competitors": [
      "Salesforce",
      "Pipedrive",
      "Zoho CRM"
    ],
    "assistants": [
      "chatgpt",
      "gemini"
    ],
    "country": "US"
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/llm/brand-mentions/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "prompts": [
        "What are the best CRM tools for small businesses?",
        "Quels sont les meilleurs logiciels CRM pour les PME ?",
        "Who founded HubSpot and in what year?"
    ],
    "brand": "HubSpot",
    "brandWebsite": "hubspot.com",
    "competitors": [
        "Salesforce",
        "Pipedrive",
        "Zoho CRM"
    ],
    "assistants": [
        "chatgpt",
        "gemini"
    ],
    "country": "US"
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/llm/brand-mentions/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "prompts": [
    "What are the best CRM tools for small businesses?",
    "Quels sont les meilleurs logiciels CRM pour les PME ?",
    "Who founded HubSpot and in what year?"
  ],
  "brand": "HubSpot",
  "brandWebsite": "hubspot.com",
  "competitors": [
    "Salesforce",
    "Pipedrive",
    "Zoho CRM"
  ],
  "assistants": [
    "chatgpt",
    "gemini"
  ],
  "country": "US"
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one answer, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `prompt` | Prompt | text |
| `assistant` | Assistant | text |
| `model` | Model | text |
| `country` | Country | text |
| `answeredAt` | Answered At | date |
| `aiAnswer` | Ai Answer | text |
| `brand` | Brand | text |
| `brandMentioned` | Brand Mentioned | boolean |
| `brandPosition` | Brand Position | number |
| `brandCited` | Brand Cited | boolean |
| `brandCitedUrls` | Brand Cited URLs | array |
| `brandsNamed` | Brands Named | array |
| `competitorsNamed` | Competitors Named | array |
| `shareOfVoice` | Share Of Voice | number |
| `aiAnswerSources` | Ai Answer Sources | object\_array |
| `sourcesCount` | Sources Count | number |
| `searchQueries` | Search Queries | array |
| `products` | Products | object\_array |
| `rowId` | Row Id | text |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "llm/brand-mentions",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "answeredAt": "2026-11-01T12:07:12Z",
      "brandMentioned": true,
      "sourcesCount": 8,
      "competitorsNamed": [],
      "brandCitedUrls": [
        "https://www.hubspot.com/company-news/author/brian-halligan-dharmesh-shah"
      ],
      "assistant": "Gemini (web)",
      "brandPosition": 1,
      "brand": "HubSpot",
      "products": [],
      "country": "US",
      "model": "3.5 Flash-Lite",
      "shareOfVoice": 1,
      "aiAnswerSources": [
        {
          "url": "https://startupintros.com/orgs/hubspot",
          "domain": "startupintros.com",
          "title": "HubSpot: Funding, Team & Investors - Startup Intros",
          "snippet": null,
          "source_name": "startupintros.com",
          "publication_date": null
        },
        {
          "url": "https://mpiresolutions.com/blog/when-was-hubspot-founded/",
          "domain": "mpiresolutions.com",
          "title": "When Was HubSpot Founded? The Origin Story Behind Growth",
          "snippet": null,
          "source_name": "mpiresolutions.com",
          "publication_date": null
        }
      ],
      "aiAnswer": "HubSpot was founded in **June 2006** by **Brian Halligan** and **Dharmesh Shah** while they were graduate students at the Massachusetts Institute of Technolo...",
      "brandCited": true,
      "prompt": "Who founded HubSpot and in what year?",
      "brandsNamed": [
        "HubSpot"
      ],
      "searchQueries": []
    }
  ]
}
```

## Related APIs

For a single assistant answer with sources use [`ai/answers`](https://docs.mindcase.co/apis/ai/answers).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.