MentionForge

Admitted input schema

{
  "type": "object",
  "properties": {
    "focus": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "praise",
        "complaint",
        "question",
        "buying",
        "news",
        "other"
      ],
      "description": "Optional intent filter applied only to returned `mentions` (praise, complaint, question, buying, news, other). Volume and sentiment stay on the full fused set."
    },
    "include_markdown": {
      "type": "boolean",
      "description": "When true, add a deterministic `markdown` brief for pasting into an agent context. Does not change the $0.02 USDC price."
    },
    "include_summary": {
      "type": "boolean",
      "description": "When true (default), include an executive `summary` string. Set false for mentions-only payloads."
    },
    "language": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional ISO 639-1 two-letter code (e.g. en). Omit for mixed-language results."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Maximum mentions to return (integer 1–50). Default 20. Does not change the $0.02 USDC price."
    },
    "min_engagement": {
      "type": "number",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Optional minimum engagement score. Omit to include all mentions in the window."
    },
    "platforms": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 0,
        "maxLength": 4096,
        "enum": [
          "x",
          "reddit",
          "web",
          "reviews",
          "news"
        ]
      },
      "minItems": 0,
      "maxItems": 100,
      "description": "Which surfaces to search. Default all of x, reddit, web, reviews, news. x and reddit use public/web adapters unless the operator enabled native APIs — this is not a guarantee of official Reddit or X search."
    },
    "query": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Natural-language or structured query about a product, company, brand, topic, or competitor. Required. Max 200 characters."
    },
    "timeframe": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Lookback window: 24h, 7d, 30d, or 90d, or a {from,to} ISO-8601 range (max 90 days). Default 7d."
    },
    "view": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "full",
        "compact"
      ],
      "description": "Optional response size. `full` (default when omitted) returns the complete mention list; `compact` returns at most 8 mentions and 8 citations. Does not change the $0.02 USDC price or aggregates."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}