Previous value: -100New value: +25

Previous value: -"Terms per reply, in rank order (default 100)."New value: +"Terms per page, in rank order."

Previous value: -"Where to start in the ranked list; each reply says next_offset."New value: +"Where to start; each reply gives next_offset."

Removed value: -"How far behind live the window ends."

Removed value: -"A ceiling on independent demand, never a count of buyers."

Removed value: -"Distinct non-seller client IPs a term needs before it is reported at all."

Removed value: -"Searches for one listed service by its own name, asked almost only by clients that searched nothing else: listed apart, same fields as top_needs, not demand. Rule in named_listing_lookup_rule."

Removed value: -"The exclusions, stated in words."

Removed value: -"offset, limit, returned, terms_total, next_offset (null on the last page)."

Removed value: -"How to read this feed, in a few lines. Read before the data."

Removed value: -"Terms asked by many client IPs almost all of which searched only once in the whole window (one caller on rotating addresses): listed apart, same fields as top_needs plus share_single_search_client_ips, not demand. Rule in scripted_rotation_rule."

Removed value: -"How many terms the window publishes; top_needs holds one page of them."

Removed value: -"Terms ranked by how many distinct days they were asked."

Removed value: -"Distinct non-seller client IPs; a ceiling on independent askers, never a count of buyers."

Removed value: -"not_checked_yet means NOT searched yet, not that nothing exists."

Removed value: -"The three listings this directory's own search returned for the term (id, name, status, price_amount), searched at catalogue_checked_at_iso. Null only when catalogue_status is not_checked_yet."

Removed value: -"UTC calendar dates on which non-sellers asked it."

Removed value: -"Of `searches`, how many came from clients that also edit listings here."

Removed value: -"Every search in the window, before exclusions."

Removed value: -"Length of the reported window."

Removed value: -"Unix seconds at which the window closes."

Added value: +{
+  "description": "Terms asked by many client IPs almost all of which searched only once in the whole window (one caller on rotating addresses): listed apart, same fields as top_needs plus share_single_search_client_ips, not demand. Rule in scripted_rotation_rule.",
+  "items": {
+    "additionalProperties": true,
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "default": 100,
+  "description": "Terms per reply, in rank order (default 100).",
+  "maximum": 1000,
+  "minimum": 1,
+  "type": "integer"
+}

Added value: +{
+  "default": 0,
+  "description": "Where to start in the ranked list; each reply says next_offset.",
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "description": "offset, limit, returned, terms_total, next_offset (null on the last page).",
+  "type": "object"
+}

Added value: +{
+  "description": "How many terms the window publishes; top_needs holds one page of them.",
+  "type": "integer"
+}

Added value: +{
+  "description": "Searches for one listed service by its own name, asked almost only by clients that searched nothing else: listed apart, same fields as top_needs, not demand. Rule in named_listing_lookup_rule.",
+  "items": {
+    "additionalProperties": true,
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "not_checked_yet means NOT searched yet, not that nothing exists.",
+  "enum": [
+    "checked",
+    "search_returned_nothing",
+    "not_checked_yet"
+  ],
+  "type": "string"
+}

Previous value: -"The three listings this directory's own search returns for the term right now (id, name, status, price_amount). Null beyond the first terms checked: search it yourself."New value: +"The three listings this directory's own search returned for the term (id, name, status, price_amount), searched at catalogue_checked_at_iso. Null only when catalogue_status is not_checked_yet."

Previous value: -"How to read this feed, in three lines. Read before the data."New value: +"How to read this feed, in a few lines. Read before the data."

Added value: +{
+  "description": "Distinct non-seller client IPs; a ceiling on independent askers, never a count of buyers.",
+  "type": "integer"
+}

Added value: +{
+  "description": "The three listings this directory's own search returns for the term right now (id, name, status, price_amount). Null beyond the first terms checked: search it yourself.",
+  "items": {
+    "additionalProperties": true,
+    "type": "object"
+  },
+  "type": [
+    "array",
+    "null"
+  ]
+}

Removed value: -{
-  "type": "integer"
-}

Added value: +{
+  "description": "UTC calendar dates on which non-sellers asked it.",
+  "type": "integer"
+}

Added value: +{
+  "description": "How to read this feed, in three lines. Read before the data.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Removed value: -{
-  "description": "Terms asked on a single day so far: same fields and same exclusions as top_needs, published unranked rather than dropped. On a window still filling these are usually the descriptive needs, because a persistence rule selects for monitors that poll daily. Read both arrays to see the whole market.",
-  "items": {
-    "additionalProperties": true,
-    "properties": {
-      "clients": {
-        "type": "integer"
-      },
-      "days_asked": {
-        "type": "integer"
-      },
-      "q": {
-        "type": "string"
-      },
-      "searches": {
-        "type": "integer"
-      },
-      "self_monitoring_searches": {
-        "description": "Of `searches`, how many came from clients that also edit listings here.",
-        "type": "integer"
-      }
-    },
-    "required": [
-      "q"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

Previous value: -"Terms asked on two or more distinct days, ranked by that count. Persistence, not volume: a burst occupies one day and cannot rank."New value: +"Terms ranked by how many distinct days they were asked."

Added value: +{
+  "description": "Terms asked on a single day so far: same fields and same exclusions as top_needs, published unranked rather than dropped. On a window still filling these are usually the descriptive needs, because a persistence rule selects for monitors that poll daily. Read both arrays to see the whole market.",
+  "items": {
+    "additionalProperties": true,
+    "properties": {
+      "clients": {
+        "type": "integer"
+      },
+      "days_asked": {
+        "type": "integer"
+      },
+      "q": {
+        "type": "string"
+      },
+      "searches": {
+        "type": "integer"
+      },
+      "self_monitoring_searches": {
+        "description": "Of `searches`, how many came from clients that also edit listings here.",
+        "type": "integer"
+      }
+    },
+    "required": [
+      "q"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Previous value: -"Terms ranked by how many distinct days they were asked."New value: +"Terms asked on two or more distinct days, ranked by that count. Persistence, not volume: a burst occupies one day and cannot rank."

Removed value: -{
-  "description": "Endpoint URLs agents asked us to resolve.",
-  "items": {
-    "additionalProperties": true,
-    "type": "object"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "What agents searched for and found nothing — the gaps in this market.",
-  "items": {
-    "additionalProperties": true,
-    "type": "object"
-  },
-  "type": "array"
-}

Previous value: -[
-  "window_days",
-  "delay_hours",
-  "total_queries",
-  "top_needs",
-  "top_zero_result_terms"
-]New value: +[
+  "window_days",
+  "delay_hours",
+  "total_queries",
+  "top_needs"
+]