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

# get_ai_mentioned_brands

> The brands AI answers mention most for a topic, ranked, with mention counts and sentiment. ₹12 per call; a result that finds nothing is ₹0.

## What it does

The brands that AI answers mention most for a topic: data with the ranked brands for each target keyword ("protein bar", "face serum") and the mention metrics behind each, on ChatGPT or Google's AI answers in one market. This is the competitive view of AI visibility: who the engines recommend when a shopper asks, and where you stand. [`get_ai_mentions`](https://parel.si/docs/tools/get_ai_mentions.md) measures one brand, [`search_ai_mentions`](https://parel.si/docs/tools/search_ai_mentions.md) shows the answers, [`get_ai_search_volume`](https://parel.si/docs/tools/get_ai_search_volume.md) the demand, [`check_ai_visibility`](https://parel.si/docs/tools/check_ai_visibility.md) a live answer. Priced per call for up to ten topics and twenty brands each, among the dearest calls in the catalogue, so batch topics. Two to ten seconds.

India: the board for Google in India is thin today and often empty (free); for Indian brands, start with get_ai_mentions and search_ai_mentions on platform google, and use this tool for the United States on chat_gpt.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `limit` | integer | no | How many brands, up to 20.; max 20 |
| `target` | array of values | no | One to ten topics, each {"keyword": "protein bar", "search_scope": ["answer"]}. |
| `platform` | string | no | google (default): Google's AI answers, any country. chat_gpt: ChatGPT, United States and English only. |
| `language_code` | string | no | Two-letter language code ("en"). |
| `location_name` | string | no | A country or city ("India", "Mumbai,Maharashtra,India"). Default United States. |

## What drives the cost

Priced per call for up to ten topics; limit caps the brands per topic at twenty. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 90 seconds.

## Price today

| | |
|---|---|
| Price today | **₹12** per call (`cost_paise: 1161`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹17.42 (`hold_paise: 1742`); 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 | 90 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "get_ai_mentioned_brands"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_ai_mentioned_brands"` |
| 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":"get_ai_mentioned_brands","input":{"limit":10,"target":[{"keyword":"sunscreen","search_scope":["answer"]}],"platform":"chat_gpt","language_code":"en","location_name":"United States"}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
{
  "total_count": 25047,
  "offset": 0,
  "items_count": 10,
  "aggregated_metrics": {
    "location": [
      {
        "key": 2840,
        "mentions": 40467,
        "ai_search_volume": 652591
      }
    ],
    "language": [
      {
        "key": "en",
        "mentions": 40467,
        "ai_search_volume": 652591
      }
    ],
    "platform": [
      {
        "key": "chat_gpt",
        "mentions": 40467,
        "ai_search_volume": 652591
      }
    ],
    "sources_domain": [
      {
        "key": "www.reddit.com",
        "mentions": 5079,
        "ai_search_volume": 38563
      },
      {
        "key": "www.ulta.com",
        "mentions": 4377,
        "ai_search_volume": 116235
      },
      {
        "key": "www.aad.org",
        "mentions": 4165,
        "ai_search_volume": 125695
      }
    ],
    "search_results_domain": [
      {
        "key": "www.allure.com",
        "mentions": 7569,
        "ai_search_volume": 143747
      },
      {
        "key": "www.vogue.com",
        "mentions": 6158,
        "ai_search_volume": 105423
      },
      {
        "key": "www.nbcnews.com",
        "mentions": 5071,
        "ai_search_volume": 108835
      }
    ],
    "brand_entities_title": [
      {
        "key": "American Academy of Dermatology",
        "mentions": 185,
        "ai_search_volume": 5123
      },
      {
        "key": "La Roche-Posay",
        "mentions": 146,
        "ai_search_volume": 1470
      },
      {
        "key": "CeraVe",
        "mentions": 117,
        "ai_search_volume": 1461
      }
    ],
    "brand_entities_category": [
      {
        "key": "product",
        "mentions": 21253,
        "ai_search_volume": 326205
      },
      {
        "key": "brand",
        "mentions": 7094,
        "ai_search_volume": 153125
      },
      {
        "key": "local_business",
        "mentions": 3276,
        "ai_search_volume": 73702
      }
    ],
    "total": {
      "mentions": 40467,
      "ai_search_volume": 652591
    }
  },
  "items": [
    {
      "brand": "American Academy of Dermatology",
      "location": [
        {
          "key": 2840,
          "mentions": 185,
          "ai_search_volume": 5123
        }
      ],
      "language": [
        {
          "key": "en",
          "mentions": 185,
          "ai_search_volume": 5123
        }
      ],
      "platform": [
        {
          "key": "chat_gpt",
          "mentions": 185,
          "ai_search_volume": 5123
        }
      ],
      "sources_domain": [
        {
          "key": "www.aad.org",
          "mentions": 180,
          "ai_search_volume": 5073
        },
        {
          "key": "pubmed.ncbi.nlm.nih.gov",
          "mentions": 34,
          "ai_search_volume": 1233
        },
        {
          "key": "health.clevelandclinic.org",
          "mentions": 26,
          "ai_search_volume": 731
        }
      ],
      "search_results_domain": [
        {
          "key": "www.aad.org",
          "mentions": 158,
          "ai_search_volume": 4989
        },
        {
          "key": "pubmed.ncbi.nlm.nih.gov",
          "mentions": 57,
          "ai_search_volume": 1904
        },
        {
          "key": "pmc.ncbi.nlm.nih.gov",
          "mentions": 45,
          "ai_search_volume": 1530
        }
      ],
      "brand_entities_title": [
        {
          "key": "American Academy of Dermatology",
          "mentions": 185,
          "ai_search_volume": 5123
        },
        {
          "key": "Cleveland Clinic",
          "mentions": 16,
          "ai_search_volume": 635
        },
        {
          "key": "Mayo Clinic",
          "mentions": 9,
          "ai_search_volume": 216
        }
      ],
      "brand_entities_category": [
        {
          "key": "organization",
          "mentions": 185,
          "ai_search_volume": 5123
        },
        {
          "key": "product",
          "mentions": 10,
          "ai_search_volume": 295
        },
        {
          "key": "brand",
          "mentions": 5,
          "ai_search_volume": 67
        }
      ],
      "total": {
        "mentions": 185,
        "ai_search_volume": 5123
      }
    },
    {
      "brand": "La Roche-Posay",
      "location": [
        {
          "key": 2840,
          "mentions": 146,
          "ai_search_volume": 1470
        }
      ],
      "language": [
        {
          "key": "en",
          "mentions": 146,
          "ai_search_volume": 1470
        }
      ],
      "platform": [
        {
          "key": "chat_gpt",
          "mentions": 146,
          "ai_search_volume": 1470
        }
      ],
      "sources_domain": [
        {
          "key": "www.laroche-posay.us",
          "mentions": 30,
          "ai_search_volume": 288
        },
        {
          "key": "www.nbcnews.com",
          "mentions": 16,
          "ai_search_volume": 244
        },
        {
          "key": "www.aad.org",
          "mentions": 13,
          "ai_search_volume": 222
        }
      ],
      "search_results_domain": [
        {
          "key": "www.laroche-posay.us",
          "mentions": 26,
          "ai_search_volume": 180
        },
        {
          "key": "www.allure.com",
          "mentions": 17,
          "ai_search_volume": 188
        },
        {
          "key": "www.vogue.com",
          "mentions": 16,
          "ai_search_volume": 282
        }
      ],
      "brand_entities_title": [
        {
          "key": "La Roche-Posay",
          "mentions": 146,
          "ai_search_volume": 1470
        },
        {
          "key": "CeraVe",
          "mentions": 68,
          "ai_search_volume": 857
        },
        {
          "key": "Vanicream",
          "mentions": 28,
          "ai_search_volume": 397
        }
      ],
      "brand_entities_category": [
        {
          "key": "brand",
          "mentions": 123,
          "ai_search_volume": 1358
        },
        {
          "key": "company",
          "mentions": 26,
          "ai_search_volume": 119
        },
        {
          "key": "product",
          "mentions": 16,
          "ai_search_volume": 138
        }
      ],
      "total": {
        "mentions": 146,
        "ai_search_volume": 1470
      }
    },
    {
      "brand": "CeraVe",
      "location": [
        {
          "key": 2840,
          "mentions": 117,
          "ai_search_volume": 1461
        }
      ],
      "language": [
        {
          "key": "en",
          "mentions": 117,
          "ai_search_volume": 1461
        }
      ],
      "platform": [
        {
          "key": "chat_gpt",
          "mentions": 117,
          "ai_search_volume": 1461
        }
      ],
      "sources_domain": [
        {
          "key": "www.cerave.com",
          "mentions": 18,
          "ai_search_volume": 288
        },
        {
          "key": "www.aad.org",
          "mentions": 16,
          "ai_search_volume": 223
        },
        {
          "key": "www.nbcnews.com",
          "mentions": 15,
          "ai_search_volume": 245
        }
      ],
      "search_results_domain": [
        {
          "key": "www.vogue.com",
          "mentions": 17,
          "ai_search_volume": 305
        },
        {
          "key": "www.allure.com",
          "mentions": 14,
          "ai_search_volume": 200
        },
        {
          "key": "www.cerave.com",
          "mentions": 12,
          "ai_search_volume": 252
        }
      ],
      "brand_entities_title": [
        {
          "key": "CeraVe",
          "mentions": 117,
          "ai_search_volume": 1461
        },
        {
          "key": "La Roche-Posay",
          "mentions": 68,
          "ai_search_volume": 857
        },
        {
          "key": "The Ordinary",
          "mentions": 30,
          "ai_search_volume": 355
        }
      ],
      "brand_entities_category": [
        {
          "key": "brand",
          "mentions": 100,
          "ai_search_volume": 1358
        },
        {
          "key": "company",
          "mentions": 19,
          "ai_search_volume": 105
        },
        {
          "key": "product",
          "mentions": 8,
          "ai_search_volume": 246
        }
      ],
      "total": {
        "mentions": 117,
        "ai_search_volume": 1461
      }
    }
  ]
}
```

## Notes

- Priced per call for up to ten topics; limit caps the brands per topic at twenty.
- The source's monthly index of AI answers, not a live prompt: for today's answer use check_ai_visibility or check_claude.
- platform chat_gpt or google; the two lists differ.
- The brand board is populated for ChatGPT in the United States; for other countries it can answer empty, which is free.

## Siblings

- [`get_ai_mentions`](https://parel.si/docs/tools/get_ai_mentions.md)
- [`search_ai_mentions`](https://parel.si/docs/tools/search_ai_mentions.md)
- [`get_ai_search_volume`](https://parel.si/docs/tools/get_ai_search_volume.md)
- [`check_ai_visibility`](https://parel.si/docs/tools/check_ai_visibility.md)
