Create AI monitoring for a brand
Create a new AI Search Watcher brand monitor — a tracked setup that measures how often a brand is mentioned and cited by AI answer engines (ChatGPT, Gemini, Claude, etc.) for a given set of prompts.
Request body:
brand— brand name to monitordomain— brand domainlocation_id— location used when collecting AI responses (see/mangools/locations)platform_id— search platform (1= desktop,2= mobile)models— array of AI model names to run the prompts againstprompts— array of prompt strings the monitor will send to each modellanguage_id— optional language for localization
Returns the newly created monitor's _id. Use POST /aiwatcher/prompts/generate first to obtain AI-suggested prompt ideas for a given brand.
Authorization
ApiKeyAuth 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
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://api.mangools.com/v3/aiwatcher/monitor" \ -H "Content-Type: application/json" \ -d '{ "location_id": 0, "platform_id": 0, "brand": "string", "domain": "string", "models": [ "string" ], "prompts": [ "string" ] }'{
"_id": "string"
}{
"error": {
"type": "AuthError",
"message": "Invalid API Key"
}
}