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 (pass0for an all-models overview)from,to— date range for the returned metrics (YYYY-MM-DD)
Authorization
ApiKeyAuth x-access-token<token>
API token issued for your Mangools account, sent as an API key in the x-access-token HTTP header. This is NOT a standard RFC 6750 Authorization: Bearer <token> header. Auto-generated clients should be configured to send the token in x-access-token accordingly.
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
Format
dateto?string
End date for data range
Format
dateResponse Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.mangools.com/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
}{
"error": {
"type": "AuthError",
"message": "Invalid API Key"
}
}{
"error": {
"type": "Error",
"message": "Monitor not found"
}
}{
"error": {
"type": "ValidationError",
"message": "Your request is invalid",
"errors": [
"Your request is invalid"
]
}
}{
"error": {
"type": "Error",
"message": "Internal server error"
}
}