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 /aiwatcher/prompts/generate first to obtain AI-suggested prompt ideas for a given brand.

POST
/aiwatcher/monitor

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

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"
  }
}