Nephia

Added value: +{
+  "description": "true keeps only opportunities: mentions of a topic or competitor keyword that are highly relevant to it and whose author is someone to answer (the keyword's agent step says problem_fit true, or, without that field, the intent is purchase_intent, comparison or question). Use it for \"who should I answer today?\". An own keyword has none. Free.",
+  "type": "boolean"
+}

Previous value: -"What the keyword is about: your own brand, a competitor's, or a topic."New value: +"What the keyword is about: your own brand, a competitor's, or a topic. A new topic without globalCriteria.match is created with match word."

Previous value: -"What the keyword is about: your own brand, a competitor's, or a topic."New value: +"What the keyword is about: your own brand, a competitor's, or a topic. A new topic without globalCriteria.match is created with match word."

Previous value: -"What the keyword is about: your own brand, a competitor's, or a topic."New value: +"What the keyword is about: your own brand, a competitor's, or a topic. A new topic without globalCriteria.match is created with match word."

Added value: +{
+  "description": "true keeps only opportunities: mentions of a topic or competitor keyword that are highly relevant to it and whose author is someone to answer (the keyword's agent step says problem_fit true, or, without that field, the intent is purchase_intent, comparison or question). Use it for \"who should I answer today?\". An own keyword has none. Free.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "The keyword colour in the dashboard. Left out on create, an unused one is picked.",
+  "enum": [
+    "keyword-1",
+    "keyword-2",
+    "keyword-3",
+    "keyword-4",
+    "keyword-5",
+    "keyword-6",
+    "keyword-7",
+    "keyword-8"
+  ],
+  "type": "string"
+}

Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 400,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "One sentence the AI reading uses to judge relevance, such as \"Acme is a cloud storage company, not the cartoon.\" null clears it."
+}

Added value: +{
+  "description": "The keyword colour in the dashboard. Left out on create, an unused one is picked.",
+  "enum": [
+    "keyword-1",
+    "keyword-2",
+    "keyword-3",
+    "keyword-4",
+    "keyword-5",
+    "keyword-6",
+    "keyword-7",
+    "keyword-8"
+  ],
+  "type": "string"
+}

Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 400,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "One sentence the AI reading uses to judge relevance, such as \"Acme is a cloud storage company, not the cartoon.\" null clears it."
+}

Added value: +{
+  "description": "The keyword colour in the dashboard. Left out on create, an unused one is picked.",
+  "enum": [
+    "keyword-1",
+    "keyword-2",
+    "keyword-3",
+    "keyword-4",
+    "keyword-5",
+    "keyword-6",
+    "keyword-7",
+    "keyword-8"
+  ],
+  "type": "string"
+}

Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 400,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "One sentence the AI reading uses to judge relevance, such as \"Acme is a cloud storage company, not the cartoon.\" null clears it."
+}

Added value: +{
+  "description": "Only mentions read as this relevant to their keyword — several are OR'd, so [\"high\", \"medium\"] leaves out what matched by accident (another meaning, a handle, spam). \"unread\" is what nothing has read yet.",
+  "items": {
+    "enum": [
+      "high",
+      "medium",
+      "low",
+      "unread"
+    ],
+    "type": "string"
+  },
+  "minItems": 1,
+  "type": "array"
+}

Previous value: -[
-  "day",
-  "hour",
-  "source",
-  "sentiment",
-  "intent",
-  "author",
-  "term",
-  "keyword"
-]New value: +[
+  "day",
+  "hour",
+  "source",
+  "sentiment",
+  "intent",
+  "relevance",
+  "author",
+  "term",
+  "keyword"
+]

Added value: +{
+  "description": "Only mentions read as this relevant to their keyword — several are OR'd, so [\"high\", \"medium\"] leaves out what matched by accident (another meaning, a handle, spam). \"unread\" is what nothing has read yet.",
+  "items": {
+    "enum": [
+      "high",
+      "medium",
+      "low",
+      "unread"
+    ],
+    "type": "string"
+  },
+  "minItems": 1,
+  "type": "array"
+}

Previous value: -"The items to read. Use this or watchId, never both."New value: +"The items to read. Use exactly one of items or keywordId."

Added value: +{
+  "description": "Read a keyword's own recent mentions instead of passing items. The id comes from list_keywords.",
+  "format": "uuid",
+  "type": "string"
+}

Previous value: -"With watchId: ISO instant, defaults to 24h ago."New value: +"With keywordId: ISO instant, defaults to 24h ago."

Removed value: -{
-  "description": "Read a watch's own recent events instead of passing items.",
-  "format": "uuid",
-  "type": "string"
-}

Added value: +{
+  "description": "Only this keyword's mentions, by id from list_keywords, including what its searches caught before they last changed. An id that is not one of the account's keywords is an error.",
+  "format": "uuid",
+  "type": "string"
+}

Previous value: -"Which producer. \"polling\" is what your Queries catch on their own; \"runs\" is a kept one-off Explore run. Absent means both."New value: +"Which producer. \"polling\" is what your keywords catch on their own; \"runs\" is a kept one-off Explore run. Absent means both."

Removed value: -{
-  "description": "Only this Query's mentions, by id from list_queries, including what its searches caught before they last changed. An id that is not one of the account's Queries is an error.",
-  "format": "uuid",
-  "type": "string"
-}

Previous value: -"The id of a mention from list_mentions or get_query_results, collected in the last 30 days."New value: +"The id of a mention from list_mentions or get_keyword_results, collected in the last 30 days."

Previous value: -"One or two axes to count along: [\"source\", \"sentiment\"] is one count per Source and sentiment. day and hour cannot be combined. author, term and query are open lists, cut at top."New value: +"One or two axes to count along: [\"source\", \"sentiment\"] is one count per Source and sentiment. day and hour cannot be combined. author, term and keyword are open lists, cut at top."

Previous value: -[
-  "day",
-  "hour",
-  "source",
-  "sentiment",
-  "intent",
-  "author",
-  "term",
-  "query"
-]New value: +[
+  "day",
+  "hour",
+  "source",
+  "sentiment",
+  "intent",
+  "author",
+  "term",
+  "keyword"
+]

Added value: +{
+  "description": "Only this keyword's mentions, by id from list_keywords, including what its searches caught before they last changed. An id that is not one of the account's keywords is an error.",
+  "format": "uuid",
+  "type": "string"
+}

Removed value: -{
-  "description": "Only this Query's mentions, by id from list_queries, including what its searches caught before they last changed. An id that is not one of the account's Queries is an error.",
-  "format": "uuid",
-  "type": "string"
-}

Previous value: -"How many authors, terms or Queries to keep, busiest first. Defaults to 10."New value: +"How many authors, terms or keywords to keep, busiest first. Defaults to 10."

Previous value: -"This search's own criteria: query (one text), terms (two or more texts OR'd, on the Sources that support it), market, filters. On ai_answers a search is a prompt: {\"filters\": {\"prompt\": \"What is the best brand monitoring tool?\", \"brands\": [\"YourBrand\"], \"engines\": [\"chatgpt\", \"gemini\", \"perplexity\"]}}."New value: +"This search's own criteria: query (one text), terms (two or more texts OR'd, on the Sources that support it), match, market, filters. On ai_answers a search is a prompt: {\"filters\": {\"prompt\": \"What is the best brand monitoring tool?\", \"brands\": [\"YourBrand\"], \"engines\": [\"chatgpt\", \"gemini\", \"perplexity\"]}}."

Previous value: -"This search's own criteria: query (one text), terms (two or more texts OR'd, on the Sources that support it), market, filters. On ai_answers a search is a prompt: {\"filters\": {\"prompt\": \"What is the best brand monitoring tool?\", \"brands\": [\"YourBrand\"], \"engines\": [\"chatgpt\", \"gemini\", \"perplexity\"]}}."New value: +"This search's own criteria: query (one text), terms (two or more texts OR'd, on the Sources that support it), match, market, filters. On ai_answers a search is a prompt: {\"filters\": {\"prompt\": \"What is the best brand monitoring tool?\", \"brands\": [\"YourBrand\"], \"engines\": [\"chatgpt\", \"gemini\", \"perplexity\"]}}."

Previous value: -"Absent: nothing is written, and the estimate of this change comes back with its token. Present: the change is written, if the arguments are the ones that were estimated."New value: +"mode \"write\" only, and required there: the estimateToken the mode \"estimate\" call returned for these same arguments. Valid 15 minutes."

Added value: +{
+  "description": "estimate writes nothing and returns the price of this change with its estimateToken; it takes no estimateToken. write saves the change and requires the estimateToken of an estimate made with the same arguments.",
+  "enum": [
+    "estimate",
+    "write"
+  ],
+  "type": "string"
+}

Previous value: -"This search's own criteria: query (one text), terms (two or more texts OR'd, on the Sources that support it), market, filters. On ai_answers a search is a prompt: {\"filters\": {\"prompt\": \"What is the best brand monitoring tool?\", \"brands\": [\"YourBrand\"], \"engines\": [\"chatgpt\", \"gemini\", \"perplexity\"]}}."New value: +"This search's own criteria: query (one text), terms (two or more texts OR'd, on the Sources that support it), match, market, filters. On ai_answers a search is a prompt: {\"filters\": {\"prompt\": \"What is the best brand monitoring tool?\", \"brands\": [\"YourBrand\"], \"engines\": [\"chatgpt\", \"gemini\", \"perplexity\"]}}."

Previous value: -[
-  "id",
-  "source",
-  "enabled"
-]New value: +[
+  "id",
+  "source",
+  "mode",
+  "enabled"
+]