Previous value: -"USDC charged for this call (`0` on trial/sandbox/replay)"New value: +"USDC charged for this call (`0` on trial/sandbox/replay/key plan)"

Added value: +{
+  "const": "key",
+  "description": "Present when billed against a Stripe API-key plan",
+  "type": "string"
+}

Previous value: -"Settlement transaction hash, or null until settle / on trial"New value: +"Settlement transaction hash, or null until settle / on trial / key plan"

Added value: +{
+  "description": "Requested platform ids skipped because they are in DISABLED_SOURCES",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Optional intent filter applied only to returned `mentions` (praise, complaint, question, buying, news, other). Volume and sentiment stay on the full fused set.",
+  "enum": [
+    "praise",
+    "complaint",
+    "question",
+    "buying",
+    "news",
+    "other"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "When true, add a deterministic `markdown` brief for pasting into an agent context. Does not change the $0.02 USDC price.",
+  "type": "boolean"
+}

Added value: +{
+  "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.",
+  "enum": [
+    "full",
+    "compact"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Deterministic pasteable brief when include_markdown was true",
+  "type": "string"
+}

Added value: +{
+  "description": "Optional product aspects tagged on this mention",
+  "items": {
+    "description": "Product aspect tagged from mention text",
+    "enum": [
+      "pricing",
+      "support",
+      "reliability",
+      "security",
+      "performance"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Optional intent class for this mention",
+  "enum": [
+    "praise",
+    "complaint",
+    "question",
+    "buying",
+    "news",
+    "other"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Optional 0–1 overlap with the query",
+  "maximum": 1,
+  "minimum": 0,
+  "type": "number"
+}

Added value: +{
+  "additionalProperties": {
+    "type": "number"
+  },
+  "description": "Optional per-platform sentiment from -1 to 1",
+  "propertyNames": {
+    "type": "string"
+  },
+  "type": "object"
+}

Previous value: -"Mention counts or scores keyed by platform id"New value: +"Mention counts keyed by platform id"

Added value: +{
+  "description": "Present when the query is a vs / multi-brand compare",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "brand": {
+        "description": "Brand or `other` when no brand token matched",
+        "type": "string"
+      },
+      "engagement": {
+        "description": "Sum of engagement for attributed mentions",
+        "type": "number"
+      },
+      "mentions": {
+        "description": "Mentions attributed to this brand",
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "share": {
+        "description": "Fraction of fused mentions (0–1)",
+        "maximum": 1,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "brand",
+      "mentions",
+      "engagement",
+      "share"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "additionalProperties": false,
+  "description": "Spike and negative-concentration flags for this window",
+  "properties": {
+    "reasons": {
+      "description": "Short reasons the agent can quote",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "risk": {
+      "description": "Crisis-style risk from volume spike and negatives",
+      "enum": [
+        "low",
+        "elevated",
+        "high"
+      ],
+      "type": "string"
+    },
+    "spike": {
+      "description": "True when the latest trend bucket is elevated vs earlier mean",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "risk",
+    "spike",
+    "reasons"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "Top non-placeholder authors by engagement",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "author": {
+        "description": "Display name or handle",
+        "type": "string"
+      },
+      "engagement": {
+        "description": "Sum of engagement",
+        "type": "number"
+      },
+      "mentions": {
+        "description": "How many fused mentions this author has",
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "platform": {
+        "description": "Surface this voice was seen on",
+        "enum": [
+          "x",
+          "reddit",
+          "web",
+          "reviews",
+          "news"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "author",
+      "platform",
+      "mentions",
+      "engagement"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +"When true (default), include an executive `summary` string. Set false for mentions-only payloads."

Added value: +"Optional ISO 639-1 two-letter code (e.g. en). Omit for mixed-language results."

Added value: +"Maximum mentions to return (integer 1–50). Default 20. Does not change the $0.02 USDC price."

Added value: +"Optional minimum engagement score. Omit to include all mentions in the window."

Added value: +"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."

Added value: +"Mention surface id: x, reddit, web, reviews, or news"

Previous value: -"Natural-language or structured query about a product, company, brand, topic, or competitor"New value: +"Natural-language or structured query about a product, company, brand, topic, or competitor. Required. Max 200 characters."

Previous value: -[
-  {
-    "enum": [
-      "24h",
-      "7d",
-      "30d",
-      "90d"
-    ],
-    "type": "string"
-  },
-  {
-    "properties": {
-      "from": {
-        "type": "string"
-      },
-      "to": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "from",
-      "to"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "description": "Named lookback: 24h, 7d, 30d, or 90d.",
+    "enum": [
+      "24h",
+      "7d",
+      "30d",
+      "90d"
+    ],
+    "type": "string"
+  },
+  {
+    "description": "Custom inclusive ISO-8601 from/to window, maximum 90 days",
+    "properties": {
+      "from": {
+        "description": "Custom range start (ISO-8601). Must be earlier than `to`.",
+        "type": "string"
+      },
+      "to": {
+        "description": "Custom range end (ISO-8601). Must be later than `from`. Window max 90 days.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "from",
+      "to"
+    ],
+    "type": "object"
+  }
+]

Added value: +"Lookback window: 24h, 7d, 30d, or 90d, or a {from,to} ISO-8601 range (max 90 days). Default 7d."

Added value: +"Sources used to build the brief"

Added value: +"When MentionForge fetched this source (ISO-8601)"

Added value: +"Publisher or site label"

Added value: +"Source title"

Added value: +"Source URL"

Added value: +"Cited mention rows (may be empty — empty windows still succeed)"

Added value: +"Display name or handle; may be empty"

Added value: +"Relative engagement score (0 when unknown)"

Added value: +"Stable mention id within this response"

Added value: +"Surface this mention was gathered from"

Added value: +"Per-mention sentiment from -1 (negative) to 1 (positive)"

Added value: +"Mention body, truncated to the engine cap"

Added value: +"When the mention was published or accessed (ISO-8601 when known)"

Added value: +"Canonical URL of the mention, or empty when the source had no permalink"

Added value: +"Request metadata including billing and freshness"

Added value: +"When this intelligence was produced (ISO-8601)"

Added value: +"Charge record for this call (never cached)"

Added value: +"USDC charged for this call (`0` on trial/sandbox/replay)"

Added value: +"True when this call used trial or sandbox and was not settled"

Added value: +"Settlement transaction hash, or null until settle / on trial"

Added value: +"Optional 0–1 confidence in the aggregate"

Added value: +"Optional list of degraded or skipped adapters"

Added value: +"live = this call; cached = research body reused, new billing"

Added value: +"Engine wall time in milliseconds (not billed)"

Added value: +"Up to three follow-up queries the agent can issue"

Added value: +"Request correlation id"

Added value: +"Adapter ids that contributed data"

Added value: +"Echo of the researched query"

Added value: +"Aggregate and per-class sentiment"

Added value: +"Breakdown of sentiment classes"

Added value: +"Mention counts or scores keyed by platform id"

Added value: +"Negative share (percent)"

Added value: +"Neutral share (percent)"

Added value: +"Positive share (percent)"

Added value: +"Share of negative mentions (percent)"

Added value: +"Share of neutral mentions (percent)"

Added value: +"Aggregate sentiment from -1 to 1"

Added value: +"Share of positive mentions (percent)"

Added value: +"Executive summary when include_summary was true"

Added value: +"Ranked themes extracted from mentions"

Added value: +"How many mentions support this theme"

Added value: +"Short supporting snippets"

Added value: +"Short theme label clustered from mention text"

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from": {
-        "type": "string"
-      },
-      "to": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "from",
-      "to"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "description": "Named window echoed back",
+    "type": "string"
+  },
+  {
+    "additionalProperties": false,
+    "description": "Custom inclusive ISO-8601 from/to window, maximum 90 days",
+    "properties": {
+      "from": {
+        "description": "Custom range start (ISO-8601). Must be earlier than `to`.",
+        "type": "string"
+      },
+      "to": {
+        "description": "Custom range end (ISO-8601). Must be later than `from`. Window max 90 days.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "from",
+      "to"
+    ],
+    "type": "object"
+  }
+]

Added value: +"Echo of the requested window"

Added value: +"Mention counts and trend for the window"

Added value: +"Per-platform mention counts (zeros when a surface returned nothing)"

Added value: +"Mentions attributed to news"

Added value: +"Mentions attributed to reddit"

Added value: +"Mentions attributed to reviews"

Added value: +"Mentions attributed to web"

Added value: +"Mentions attributed to x"

Added value: +"Total mentions in the window after filtering"

Added value: +"Time-bucketed mention counts across the window"

Added value: +"Mentions in this bucket"

Added value: +"Bucket start (ISO-8601)"