Watch your brand across AI answers

Monitors send your prompt set to the AI engines you choose on a schedule and score every answer for your brand’s mentions and citations.

What you get

• Mention rate: the share of answers that name your brand, by engine and by prompt.
• Citation rate: the share of answers that cite one of your domains.
• A prompt by engine grid that shows where your brand appears, with the full answer behind every cell.
• An email alert when the mention rate drops below the threshold you set.

How it works

A monitor is a named prompt set in one market: the prompts, the engines to ask, the names that mean your brand, your domains, a country and a schedule from hourly to weekly. Each run sends every prompt to every engine and scores each answer once: whether it names your brand and where, whether it cites your domains and which competitors appear beside you.

Every number links to the answers behind it, so when a rate moves you open the exact answers that changed and see what the engines said.

Where it helps

• Track your share of AI answers for the questions your buyers ask, week after week.
• Find the prompts and engines where competitors appear ahead of you.
• Watch mention and citation rates move after you publish new content.

Get started

Create a monitor from Monitors in the dashboard or with POST /v1/monitors. A prompt that contains your brand name always counts as a mention, so write prompts in the words a buyer would use.

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, US",
    "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
    "prompts": [
      "best running shoes for flat feet",
      "most comfortable running shoes for beginners"
    ],
    "aliases": ["Acme", "Acme Running"],
    "domains": ["acme.com"],
    "country": "US",
    "intervalHours": 24,
    "alertBelowPct": 30
  }'

Request fields

namestringRequired

A name for the monitor.

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.

aliasesarrayRequired

Your brand’s names and spellings, up to 20. An answer that uses one counts as a mention.

domainsarray

Your sites, up to 20. An answer that cites one counts as a citation.

competitorsarray

Brands to compare with, each with name and aliases. The weekly read adds the ones the answers name.

countrystring

The market the engines answer for. Default US.

intervalHoursinteger

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

alertBelowPctinteger

Email alert when your mention rate falls under this percentage, 1 to 100.

Response

The response, trimmed for length.

{
  "success": true,
  "data": {
    "monitor": {
      "id": "…",
      "name": "Running shoes, US",
      "mode": "BRAND",
      "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
      "country": "US",
      "intervalHours": 24,
      "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 results

Each run adds one row per prompt and engine. GET /v1/monitors/{id}/results lists the rows newest first, and nextCursor goes back as cursor for the next page. These rows come from the public running shoes report, trimmed for length.

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

{
  "success": true,
  "data": {
    "monitor": {
      "id": "0b787ca9-f680-47ac-beaa-72c383b597c1",
      "name": "Running shoes market (US)"
    },
    "truncated": true,
    "nextCursor": "2026-09-30T11:51:14.888000Z~7fc7c713-a2f2-41f8-befd-c04b830d69e5",
    "results": [
      {
        "taskId": "bc96f867-7349-4987-b498-f0080c149f3d",
        "engine": "PERPLEXITY",
        "prompt": "What are the best waterproof running shoes to choose?",
        "mentioned": false,
        "cited": false,
        "position": null,
        "ranAt": "2026-09-30T11:51:33.415000Z",
        "competitorHits": ["HOKA", "On", "Brooks", "Salomon"]
      },
      {
        "taskId": "6b8222fd-01bd-44d7-9a0b-8d0aecb32e19",
        "engine": "PERPLEXITY",
        "prompt": "What are the best running shoes for kids?",
        "mentioned": false,
        "cited": false,
        "position": null,
        "ranAt": "2026-09-30T11:51:14.888000Z",
        "competitorHits": ["HOKA", "On", "ASICS", "Nike", "New Balance"]
      }
    ]
  }
}

mentionedboolean

true when the answer names your brand by one of its aliases.

citedboolean

true when the answer cites a page on one of your domains.

positioninteger

Character offset of your brand’s first mention in the answer, a measure of prominence. null when the answer leaves your brand out.

competitorHitsarray

The competitors the answer names.

taskIdstring

The answer behind the row. GET /v1/monitors/{id}/answers/{taskId} returns it in full, with its sources.

Pricing

A run costs the number of prompts times the credits of each engine. For example, 12 prompts on ChatGPT (2 credits) and Gemini (1 credit) cost 36 credits a run, about 1,080 credits a month on a daily schedule.