Mangools/API

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 monitor
  • domain — brand domain
  • location_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 against
  • prompts — array of prompt strings the monitor will send to each model
  • language_id — optional language for localization

Returns the newly created monitor's _id. Use POST /v3/aiwatcher/prompts/generate first to obtain AI-suggested prompt ideas for a given brand.

POST
/v3/aiwatcher/monitor

Authorization

ApiKeyAuth
x-access-token<token>

Your Mangools API key

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://api.mangools.com/v3/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"
}