BrandKarma

create_monitored_query

Creates a new AI visibility monitoring query (prompt) for a brand. Call list_prompt_industries for this brand first: 'industry' must be one of the values it returns, because that field groups prompts into rows in the customer's report.

Remote Account required revuo:brandkarma-4084

Remote (network-hosted) · Requires an account with the vendor · OAuth

Other tools also called create_monitored_query? See providers with this name

Input Schema


            {
  "type": "object",
  "properties": {
    "brandId": {
      "description": "Brand ID (ObjectId)",
      "type": "string"
    },
    "displayName": {
      "description": "Display name for this query",
      "type": "string"
    },
    "prompt": {
      "description": "The prompt text to send to LLMs",
      "type": "string"
    },
    "queryType": {
      "description": "Query type. UnaidedAwareness: the prompt must NOT name the brand, it measures whether the model brings the brand up unprompted. Reputation: the prompt DOES name the brand, it measures what the model says about a brand already in the conversation. ProductRecommendation: asks for advice in a product category. Custom: anything else, excluded from the standard scores.",
      "type": "string",
      "default": "Custom"
    },
    "industry": {
      "description": "The report bucket for this prompt. Must be one of the brand's declared categories or industries — call list_prompt_industries to get them, and copy one exactly. A value outside that set is snapped to the closest one rather than kept: this field is a grouping key, and a new value would create a report row holding a single prompt, which produces a score over a sample of one.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "aspect": {
      "description": "Aspect to focus on (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "status": {
      "description": "Status: Auto, On, Off (default Auto)",
      "type": "string",
      "default": "Auto"
    },
    "countryCode": {
      "description": "Market override for this prompt, as a 2-letter country code. Omit to follow the brand's market, which is almost always right — a value here pins the prompt to one country even after the brand moves.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "languageCode": {
      "description": "Language override for this prompt. Omit to follow the brand's language.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    }
  },
  "required": [
    "brandId",
    "displayName",
    "prompt"
  ]
}