Mangools/API

Generate AI prompts for brand monitoring

Generate suggested monitoring prompts and a brand-perception summary for a given brand — useful during monitor onboarding so users do not have to come up with AI Search Watcher prompts manually.

Request body:

  • brand — brand name to analyze
  • domain — brand domain
  • location_id — location used when collecting suggestions (see /mangools/locations)
  • platform_id — search platform (1 = desktop, 2 = mobile)
  • language_id — optional language for prompt generation

Response:

  • prompts — array of suggested prompt strings ready to pass into POST /aiwatcher/monitor
  • perception — a short textual summary of how AI models currently describe the brand
POST
/aiwatcher/prompts/generate

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/prompts/generate" \  -H "Content-Type: application/json" \  -d '{    "location_id": 0,    "platform_id": 0,    "brand": "string",    "domain": "string"  }'
{
  "prompts": [
    "string"
  ],
  "perception": "string"
}
{
  "error": {
    "type": "AuthError",
    "message": "Invalid API Key"
  }
}