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