Track a whole market with category monitors

Category monitors rank the brands AI engines name across a market, with share of voice and daily trends.

What you get

• A ranking of every tracked brand the answers name, with its rank, mention rate, share of voice and change against the previous interval.
• The three brands named most in each sub-field and on each engine, so you see where every brand is strong.
• Daily rates for the five leading brands, and a cell per prompt and engine that opens the answer behind it.

How it works

A brand monitor follows one brand. A category monitor follows a market: you name the category, group its prompts by sub-field, and every run asks your engines those prompts and records which brands each answer names. Set mode to CATEGORY when you create it; the type stays fixed for the life of the monitor.

• category: the market as a buyer names it, 1 to 80 characters.
• promptTopics: maps each prompt to its sub-field, with up to 30 sub-fields of at most 60 characters. Prompts outside the map cover the whole category.
• competitors: up to 25 brands you list. After the first run, a weekly read of the answers adds up to 25 more brands they name.

GET /v1/monitors/{id}/analytics returns the report. In category.brands, share of voice is 100 × a brand’s mentions ÷ all tracked mentions, so the shares in one window add up to 100. A brand’s rate divides by its own sampleSize, the answers scored while it was on the list, so a brand you add today is measured from today.

Where it helps

• Find out which brands lead your market in AI answers, and by how much.
• See which sub-fields and engines each competitor owns.
• Report category share of voice to clients or leadership every week.

Get started

In the dashboard, create a monitor and pick Category as the monitor type. Enter a topic and select Run research: Prompt Research fills in the prompts, their sub-fields and the brands to rank from search demand in KR or US, and you review everything before the monitor is created.

Send a request

Send the request with your API key in the Authorization header.

curl -X POST https://api.querying.ai/v1/monitors \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Running shoes market (US)",
    "mode": "CATEGORY",
    "category": "Running shoes",
    "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
    "prompts": [
      "What are the best running shoes to choose?",
      "What are the best trail running shoes to choose?",
      "What are the best waterproof running shoes to choose?"
    ],
    "promptTopics": {
      "What are the best running shoes to choose?": "Choosing running shoes",
      "What are the best trail running shoes to choose?": "Trail running shoes",
      "What are the best waterproof running shoes to choose?": "Running shoe features"
    },
    "competitors": [
      { "name": "HOKA" },
      { "name": "On" },
      { "name": "Nike" }
    ],
    "country": "US",
    "intervalHours": 168
  }'

Request fields

namestringRequired

A name for the monitor.

modestringRequired

BRAND (default) tracks your brand. CATEGORY ranks every brand in a market.

categorystringRequired

The market’s name, 1 to 80 characters.

enginesarrayRequired

Engines to ask, up to 12, such as CHATGPT, GEMINI, PERPLEXITY and GOOGLE.

promptsarrayRequired

1 to 100 questions asked on every run, written the way a buyer asks them.

promptTopicsobject

Maps each prompt to a sub-field, such as Kids. The report ranks brands per sub-field.

competitorsarray

The brands to rank from the start, up to 25. The weekly read adds up to 25 more from the answers.

countrystring

The market the engines answer for. Default US.

intervalHoursinteger

Hours between runs, 1 to 168: 1 hourly, 24 daily, 168 weekly.

Response

The response, trimmed for length.

{
  "success": true,
  "data": {
    "monitor": {
      "id": "…",
      "name": "Running shoes market (US)",
      "mode": "CATEGORY",
      "category": "Running shoes",
      "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
      "country": "US",
      "intervalHours": 168,
      "enabled": true,
      "nextRunAt": "…"
    }
  }
}

data.monitor.idstring

The monitor’s ID. Use it to read the report, the scored results and each answer.

data.monitor.nextRunAtstring

When the next run starts. The first run starts the moment the monitor is created, then one runs every intervalHours.

Read the report

GET /v1/monitors/{id}/analytics returns the report for the last 30 days. The numbers below come from the public running shoes report, trimmed for length.

curl "https://api.querying.ai/v1/monitors/$MONITOR_ID/analytics" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

{
  "success": true,
  "data": {
    "monitor": {
      "id": "0b787ca9-f680-47ac-beaa-72c383b597c1",
      "name": "Running shoes market (US)",
      "mode": "CATEGORY"
    },
    "window": {
      "since": "2026-09-02T17:23:17.290Z",
      "until": "2026-10-02T17:23:17.290Z"
    },
    "category": {
      "name": "Running shoes",
      "brands": [
        {
          "rank": 1,
          "name": "On",
          "mentions": 21,
          "sampleSize": 21,
          "mentionRate": 100,
          "shareOfVoice": 18.421052631578945,
          "changePp": null
        },
        {
          "rank": 2,
          "name": "HOKA",
          "mentions": 15,
          "sampleSize": 21,
          "mentionRate": 71.42857142857143,
          "shareOfVoice": 13.157894736842104,
          "changePp": null
        },
        {
          "rank": 3,
          "name": "Nike",
          "mentions": 14,
          "sampleSize": 21,
          "mentionRate": 66.66666666666666,
          "shareOfVoice": 12.280701754385964,
          "changePp": null
        }
      ],
      "topics": [
        {
          "topic": "Trail running shoes",
          "prompts": 1,
          "runs": 3,
          "leaders": [
            { "name": "HOKA", "mentionRate": 100 },
            { "name": "On", "mentionRate": 100 },
            { "name": "Salomon", "mentionRate": 100 }
          ]
        }
      ]
    }
  }
}

category.brandsarray

The brands on your list and every other brand the answers name, most answers first, with rank, mentionRate and shareOfVoice.

category.topicsarray

The same ranking for each sub-field, in the order the monitor asks them.

Export the answers

GET /v1/monitors/{id}/results lists one row per answer, with the brands it names in competitorHits. Add format=csv for a file that opens in any spreadsheet:

curl "https://api.querying.ai/v1/monitors/$MONITOR_ID/results?format=csv" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

ran_at,monitor,engine,prompt,mentioned,cited,position,competitors,task_id
2026-09-30T11:52:14.381000Z,Running shoes market (US),PERPLEXITY,What are the best barefoot running shoes to choose?,false,false,,On | Nike | Vibram | Merrell | Xero Shoes | Vivobarefoot | Whitin,39bc264d-205f-4824-8750-7bb6564fa4d0
2026-09-30T11:51:33.415000Z,Running shoes market (US),PERPLEXITY,What are the best waterproof running shoes to choose?,false,false,,HOKA | On | Brooks | Salomon,bc96f867-7349-4987-b498-f0080c149f3d
2026-09-30T11:51:14.888000Z,Running shoes market (US),PERPLEXITY,What are the best running shoes for kids?,false,false,,HOKA | On | ASICS | Nike | New Balance,6b8222fd-01bd-44d7-9a0b-8d0aecb32e19

Pricing

A run costs the same as a brand monitor run: one task per prompt per engine, at each engine’s credit price. Finding the market’s brands adds 100 credits a month, split across runs, and the research that fills the form costs 12 credits.