Mangools/API

Get AI monitoring detail for a brand

Get detailed analytics for a single AI Search Watcher monitor — how often the brand is mentioned across the configured AI models and prompts, citation sources returned by the models, sentiment signals, and visibility changes over time.

Query parameters:

  • models — comma-separated model IDs to include (pass 0 for an all-models overview)
  • from, to — date range for the returned metrics (YYYY-MM-DD)
GET
/v3/aiwatcher/monitor/{id}

Authorization

ApiKeyAuth
x-access-token<token>

Your Mangools API key

In: header

Path Parameters

id*string

Monitor ID

Query Parameters

models?string

Comma-separated model IDs (0 means all models overview)

from?string

Start date for data range

Formatdate
to?string

End date for data range

Formatdate

Response Body

application/json

curl -X GET "https://api.mangools.com/v3/v3/aiwatcher/monitor/string"
{
  "_id": "string",
  "user_id": "string",
  "creator": "string",
  "location_id": 0,
  "language_id": 0,
  "platform_id": 0,
  "brand": "string",
  "brandVariations": [
    "string"
  ],
  "domain": "string",
  "perception": "string",
  "perceptions": {
    "property1": "string",
    "property2": "string"
  },
  "models": [
    0
  ],
  "history": {
    "property1": {
      "state": "PREPARE",
      "updatedAt": 0,
      "error": "string",
      "aggregatedStats": {
        "overall": {
          "avgVisibility": 0,
          "avgPosition": 0,
          "avgScore": 0,
          "totalCost": 0,
          "cost": 0,
          "topBrands": [
            {
              "recommendation": "string",
              "avgScore": 0,
              "avgVisibility": 0,
              "avgPosition": 0,
              "frequency": 0,
              "isMatch": true
            }
          ]
        },
        "byModel": {
          "property1": {
            "avgVisibility": 0,
            "avgPosition": 0,
            "avgScore": 0,
            "totalCost": 0,
            "cost": 0,
            "topBrands": [
              {
                "recommendation": "string",
                "avgScore": 0,
                "avgVisibility": 0,
                "avgPosition": 0,
                "frequency": 0,
                "isMatch": true
              }
            ]
          },
          "property2": {
            "avgVisibility": 0,
            "avgPosition": 0,
            "avgScore": 0,
            "totalCost": 0,
            "cost": 0,
            "topBrands": [
              {
                "recommendation": "string",
                "avgScore": 0,
                "avgVisibility": 0,
                "avgPosition": 0,
                "frequency": 0,
                "isMatch": true
              }
            ]
          }
        },
        "byPrompt": {
          "property1": {
            "avgVisibility": 0,
            "avgPosition": 0,
            "avgScore": 0,
            "totalCost": 0,
            "cost": 0,
            "topBrands": [
              {
                "recommendation": "string",
                "avgScore": 0,
                "avgVisibility": 0,
                "avgPosition": 0,
                "frequency": 0,
                "isMatch": true
              }
            ]
          },
          "property2": {
            "avgVisibility": 0,
            "avgPosition": 0,
            "avgScore": 0,
            "totalCost": 0,
            "cost": 0,
            "topBrands": [
              {
                "recommendation": "string",
                "avgScore": 0,
                "avgVisibility": 0,
                "avgPosition": 0,
                "frequency": 0,
                "isMatch": true
              }
            ]
          }
        }
      }
    },
    "property2": {
      "state": "PREPARE",
      "updatedAt": 0,
      "error": "string",
      "aggregatedStats": {
        "overall": {
          "avgVisibility": 0,
          "avgPosition": 0,
          "avgScore": 0,
          "totalCost": 0,
          "cost": 0,
          "topBrands": [
            {
              "recommendation": "string",
              "avgScore": 0,
              "avgVisibility": 0,
              "avgPosition": 0,
              "frequency": 0,
              "isMatch": true
            }
          ]
        },
        "byModel": {
          "property1": {
            "avgVisibility": 0,
            "avgPosition": 0,
            "avgScore": 0,
            "totalCost": 0,
            "cost": 0,
            "topBrands": [
              {
                "recommendation": "string",
                "avgScore": 0,
                "avgVisibility": 0,
                "avgPosition": 0,
                "frequency": 0,
                "isMatch": true
              }
            ]
          },
          "property2": {
            "avgVisibility": 0,
            "avgPosition": 0,
            "avgScore": 0,
            "totalCost": 0,
            "cost": 0,
            "topBrands": [
              {
                "recommendation": "string",
                "avgScore": 0,
                "avgVisibility": 0,
                "avgPosition": 0,
                "frequency": 0,
                "isMatch": true
              }
            ]
          }
        },
        "byPrompt": {
          "property1": {
            "avgVisibility": 0,
            "avgPosition": 0,
            "avgScore": 0,
            "totalCost": 0,
            "cost": 0,
            "topBrands": [
              {
                "recommendation": "string",
                "avgScore": 0,
                "avgVisibility": 0,
                "avgPosition": 0,
                "frequency": 0,
                "isMatch": true
              }
            ]
          },
          "property2": {
            "avgVisibility": 0,
            "avgPosition": 0,
            "avgScore": 0,
            "totalCost": 0,
            "cost": 0,
            "topBrands": [
              {
                "recommendation": "string",
                "avgScore": 0,
                "avgVisibility": 0,
                "avgPosition": 0,
                "frequency": 0,
                "isMatch": true
              }
            ]
          }
        }
      }
    }
  },
  "has_pending_changes": true,
  "perception_stale": true,
  "share_token": "string",
  "created_at": 0,
  "updated_at": 0,
  "deleted_at": 0
}
Empty
Empty
Empty