@invinite-org/invinite-data-cli 0.9.0 → 0.10.0

package/dist/src/generated/cli-manifest.json

@@ -1,6 +1,6 @@
 {
   "specVersion": "1.0.0",
-  "specSha256": "587da531928006a2a7259d0f0ca16b340afffbf652b13603890f4579dcacea59",
+  "specSha256": "6c548f91ff9a962b3dd46e4059a57540f1bee64691c69d704d6de35cef78190b",
   "groups": [
     {
       "name": "company",
@@ -42,6 +42,10 @@
       "name": "metrics",
       "description": "Ratios, growth and CAGR derived from the statements"
     },
+    {
+      "name": "news",
+      "description": "News of US companies from SEC filings and their own newsrooms: items, full text with attribution, developments and files"
+    },
     {
       "name": "ownership",
       "description": "13F holdings, holders and position changes of institutional investors"
@@ -79,7 +83,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         }
       ],
@@ -139,7 +143,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -223,7 +227,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -358,7 +362,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -1136,8 +1140,8 @@
           "in": "query",
           "required": true,
           "type": "string",
-          "example": "revenue",
-          "description": "Normalized metric (e.g. revenue, eps_non_gaap, segment:iphone)"
+          "example": "revenue_growth",
+          "description": "Normalized metric (e.g. revenue, eps_non_gaap, revenue_growth, segment:iphone)"
         },
         {
           "name": "period_kind",
@@ -2298,7 +2302,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -2320,7 +2324,7 @@
           "required": false,
           "type": "string",
           "example": "part_i-item_1a",
-          "description": "Optional section ID. If not specified, all sections from the filing are returned."
+          "description": "Optional section ID. If not specified, all sections from the filing are returned. A section the filing does not have answers 404 with the section IDs it has."
         },
         {
           "name": "accession_number",
@@ -2368,7 +2372,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -2441,7 +2445,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -2527,7 +2531,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -2600,7 +2604,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -2673,7 +2677,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -2759,7 +2763,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -2832,7 +2836,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -2905,7 +2909,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -2991,7 +2995,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -3064,7 +3068,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL,MSFT",
-          "description": "Comma-separated list of ticker symbols or CIKs (1-10 identifiers)",
+          "description": "Comma-separated list of ticker symbols or CIKs (1-10 identifiers). Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -3117,7 +3121,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL,MSFT",
-          "description": "Comma-separated list of ticker symbols or CIKs (1-10 identifiers)",
+          "description": "Comma-separated list of ticker symbols or CIKs (1-10 identifiers). Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -3183,7 +3187,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL,MSFT",
-          "description": "Comma-separated list of ticker symbols or CIKs (1-10 identifiers)",
+          "description": "Comma-separated list of ticker symbols or CIKs (1-10 identifiers). Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -3236,7 +3240,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -3309,7 +3313,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -3395,7 +3399,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -3468,7 +3472,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -3541,7 +3545,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -3627,7 +3631,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -3700,7 +3704,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -3773,7 +3777,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -3859,7 +3863,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -3932,7 +3936,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL,MSFT",
-          "description": "Comma-separated list of ticker symbols or CIKs (1-10 identifiers)",
+          "description": "Comma-separated list of ticker symbols or CIKs (1-10 identifiers). Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -3985,7 +3989,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL,MSFT",
-          "description": "Comma-separated list of ticker symbols or CIKs (1-10 identifiers)",
+          "description": "Comma-separated list of ticker symbols or CIKs (1-10 identifiers). Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -4051,7 +4055,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL,MSFT",
-          "description": "Comma-separated list of ticker symbols or CIKs (1-10 identifiers)",
+          "description": "Comma-separated list of ticker symbols or CIKs (1-10 identifiers). Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -4120,7 +4124,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Company ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -4501,7 +4505,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -4572,7 +4576,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -4657,7 +4661,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -4729,6 +4733,568 @@
         "periods"
       ]
     },
+    {
+      "operationId": "newsAssetDownload",
+      "group": "news",
+      "action": "asset-download",
+      "method": "get",
+      "path": "/v1/news/{id}/assets/{asset_id}/download",
+      "auth": true,
+      "summary": "Get a short-lived URL of a news image or file",
+      "params": [
+        {
+          "name": "id",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "4c1d9e62-3b7a-4f2e-8d1c-9e0a7b6c5d4f",
+          "description": "News item id"
+        },
+        {
+          "name": "asset_id",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "7e2f0c19-5a8b-4d3e-9f1a-2b6c8d0e4a7b",
+          "description": "Asset id (`assets[].id` of the item)"
+        }
+      ],
+      "view": "keyValue",
+      "columns": [
+        "purpose",
+        "url",
+        "expires_at",
+        "content_type",
+        "credit"
+      ],
+      "pagination": "none"
+    },
+    {
+      "operationId": "newsDevelopments",
+      "group": "news",
+      "action": "developments",
+      "method": "get",
+      "path": "/v1/news/developments",
+      "auth": true,
+      "summary": "List company developments from news",
+      "params": [
+        {
+          "name": "publisher",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "1045810"
+          ],
+          "description": "Published by these companies (CIK, padded or not; ≤ 20): an item with a verified issuer-newsroom publication of one of them — not a mention, not the item's first source. The CIK namespace is the SEC's"
+        },
+        {
+          "name": "topic",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "product_launch"
+          ],
+          "description": "Only these topics, comma-separated or repeated: product_launch, product_update, availability, partnership, customer_contract, capacity_expansion, regulatory, research"
+        },
+        {
+          "name": "item_id",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "4c1d9e62-3b7a-4f2e-8d1c-9e0a7b6c5d4f",
+          "description": "Only the developments of this news item"
+        },
+        {
+          "name": "from",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-10-22",
+          "description": "Start of the announcement window: an ISO 8601 instant or a day (YYYY-MM-DD, from its UTC midnight). Default: `to` minus 7 days"
+        },
+        {
+          "name": "to",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-10-29",
+          "description": "End of the announcement window: an ISO 8601 instant (exclusive) or a day (inclusive). Default: now. At most 92 days after `from` (400 otherwise)"
+        },
+        {
+          "name": "effective_from",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-10-01",
+          "description": "Effective on or after this day (developments without an effective date are left out)"
+        },
+        {
+          "name": "effective_to",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-12-31",
+          "description": "Effective on or before this day (developments without an effective date are left out)"
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 50,
+          "example": 20,
+          "description": "Developments per page"
+        },
+        {
+          "name": "cursor",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "WyIyMDI2LTEwLTI5VDIwOjMwOjA1LjEyMzQ1NloiLCI0YzFkOWU2Mi0zYjdhLTRmMmUtOGQxYy05ZTBhN2I2YzVkNGYiXQ",
+          "description": "`next_cursor` of the previous page (with the same filters); an altered or foreign cursor is a 400 `invalid_cursor`"
+        }
+      ],
+      "view": "table",
+      "rowsPath": "developments",
+      "columns": [
+        "announced_at",
+        "topic",
+        "claim_status",
+        "title",
+        "item.attribution.publisher"
+      ],
+      "pagination": "top",
+      "allItemsPath": [
+        "developments"
+      ]
+    },
+    {
+      "operationId": "newsItem",
+      "group": "news",
+      "action": "get",
+      "method": "get",
+      "path": "/v1/news/{id}",
+      "auth": true,
+      "summary": "Get a news item",
+      "params": [
+        {
+          "name": "id",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "4c1d9e62-3b7a-4f2e-8d1c-9e0a7b6c5d4f",
+          "description": "News item id"
+        }
+      ],
+      "view": "keyValue",
+      "columns": [
+        "id",
+        "published_at",
+        "title",
+        "kind",
+        "source.id",
+        "url",
+        "content_status",
+        "attribution.publisher",
+        "attribution.publisher_host",
+        "attribution.source_url",
+        "attribution.published_at",
+        "attribution.rights",
+        "attribution.edgar.form",
+        "attribution.edgar.accession",
+        "attribution.statement",
+        "body_text"
+      ],
+      "pagination": "none"
+    },
+    {
+      "operationId": "newsItems",
+      "group": "news",
+      "action": "list",
+      "method": "get",
+      "path": "/v1/news",
+      "auth": true,
+      "summary": "List news items",
+      "params": [
+        {
+          "name": "ticker",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "NVDA"
+          ],
+          "description": "Items mentioning these tickers (≤ 20, comma-separated or repeated). `BRK.B` and `BRK-B` both match; responses carry the stored dash spelling. With `cik`, either matches"
+        },
+        {
+          "name": "cik",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "1045810"
+          ],
+          "description": "Items mentioning these companies by CIK (padded or not, ≤ 20). With `ticker`, either matches"
+        },
+        {
+          "name": "from",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-10-22",
+          "description": "Start of the publication window: an ISO 8601 instant or a day (YYYY-MM-DD, from its UTC midnight). Default: `to` minus 7 days"
+        },
+        {
+          "name": "to",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-10-29",
+          "description": "End of the publication window: an ISO 8601 instant (exclusive) or a day (inclusive). Default: now. At most 92 days after `from` (400 otherwise)"
+        },
+        {
+          "name": "source",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "edgar"
+          ],
+          "description": "The item's FIRST source: `edgar` (an SEC filing) or `ir` (any company newsroom), comma-separated or repeated"
+        },
+        {
+          "name": "kind",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "earnings_results"
+          ],
+          "description": "Only these kinds, comma-separated or repeated: earnings_results, results_date, call_announcement, event_announcement, guidance, m_and_a, material_agreement, management_change, dividend, capital_markets, legal_spam, promo, other"
+        },
+        {
+          "name": "topic",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "product_launch"
+          ],
+          "description": "Only these topics (any of them), comma-separated or repeated: product_launch, product_update, availability, partnership, customer_contract, capacity_expansion, regulatory, research, other"
+        },
+        {
+          "name": "earnings",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "example": "true",
+          "description": "true = only earnings news (results, results dates, call announcements, guidance); false = none of it"
+        },
+        {
+          "name": "publisher",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "1045810"
+          ],
+          "description": "Published by these companies (CIK, padded or not; ≤ 20): an item with a verified issuer-newsroom publication of one of them — not a mention, not the item's first source. The CIK namespace is the SEC's"
+        },
+        {
+          "name": "publication_type",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "press_release"
+          ],
+          "description": "Only these publication types of the issuer's own publication, comma-separated or repeated: press_release, company_blog, company_update"
+        },
+        {
+          "name": "issuer_category",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "Press Releases"
+          ],
+          "description": "The publisher's own newsroom category, by exact label or by the publisher's category id (≤ 10); needs exactly one `publisher` — labels and ids are per newsroom"
+        },
+        {
+          "name": "issuer_tag",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "Data Center"
+          ],
+          "description": "The publisher's own newsroom tag, by exact label or id (≤ 10); needs exactly one `publisher`"
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 50,
+          "example": 20,
+          "description": "Items per page"
+        },
+        {
+          "name": "cursor",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "WyIyMDI2LTEwLTI5VDIwOjMwOjA1LjEyMzQ1NloiLCI0YzFkOWU2Mi0zYjdhLTRmMmUtOGQxYy05ZTBhN2I2YzVkNGYiXQ",
+          "description": "`next_cursor` of the previous page (with the same filters); an altered or foreign cursor is a 400 `invalid_cursor`"
+        }
+      ],
+      "view": "table",
+      "rowsPath": "items",
+      "columns": [
+        "published_at",
+        "source.id",
+        "kind",
+        "is_earnings_news",
+        "symbols",
+        "title",
+        "attribution.publisher"
+      ],
+      "pagination": "top",
+      "allItemsPath": [
+        "items"
+      ]
+    },
+    {
+      "operationId": "newsSearch",
+      "group": "news",
+      "action": "search",
+      "method": "get",
+      "path": "/v1/news/search",
+      "auth": true,
+      "summary": "Search news",
+      "params": [
+        {
+          "name": "q",
+          "in": "query",
+          "required": true,
+          "type": "string",
+          "example": "data center revenue",
+          "description": "The keywords or phrases (mode=lexical) or exact text (mode=literal) to search for",
+          "alias": "q"
+        },
+        {
+          "name": "mode",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "lexical",
+            "literal"
+          ],
+          "default": "lexical",
+          "example": "lexical",
+          "description": "lexical (keywords and phrases, default) or literal (exact characters)",
+          "alias": "m"
+        },
+        {
+          "name": "case_sensitive",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "example": "false",
+          "description": "mode=literal only: \"false\" matches regardless of case (default \"true\": case-sensitive)"
+        },
+        {
+          "name": "field",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "title",
+            "body",
+            "any"
+          ],
+          "default": "any",
+          "example": "any",
+          "description": "title = headlines and ledes, body = the item text, any = both"
+        },
+        {
+          "name": "ticker",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "NVDA"
+          ],
+          "description": "Items mentioning these tickers (≤ 20, comma-separated or repeated). `BRK.B` and `BRK-B` both match; responses carry the stored dash spelling. With `cik`, either matches",
+          "alias": "t"
+        },
+        {
+          "name": "cik",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "1045810"
+          ],
+          "description": "Items mentioning these companies by CIK (padded or not, ≤ 20). With `ticker`, either matches"
+        },
+        {
+          "name": "publisher",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "1045810"
+          ],
+          "description": "Published by these companies (CIK, padded or not; ≤ 20): an item with a verified issuer-newsroom publication of one of them — not a mention, not the item's first source. The CIK namespace is the SEC's"
+        },
+        {
+          "name": "kind",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "earnings_results"
+          ],
+          "description": "Only these kinds, comma-separated or repeated: earnings_results, results_date, call_announcement, event_announcement, guidance, m_and_a, material_agreement, management_change, dividend, capital_markets, legal_spam, promo, other"
+        },
+        {
+          "name": "topic",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "product_launch"
+          ],
+          "description": "Only these topics (any of them), comma-separated or repeated: product_launch, product_update, availability, partnership, customer_contract, capacity_expansion, regulatory, research, other"
+        },
+        {
+          "name": "from",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-07-01",
+          "description": "Start of the publication window: an ISO 8601 instant or a day (YYYY-MM-DD, from its UTC midnight). Default: `to` minus 365 days"
+        },
+        {
+          "name": "to",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-10-29",
+          "description": "End of the publication window: an ISO 8601 instant (exclusive) or a day (inclusive). Default: now. At most 731 days after `from` (400 otherwise)"
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 5,
+          "example": 5,
+          "description": "Maximum number of passages (at most 8)",
+          "alias": "l"
+        }
+      ],
+      "exampleParams": [
+        "ticker",
+        "mode"
+      ],
+      "view": "table",
+      "rowsPath": "hits",
+      "columns": [
+        "score",
+        "match.type",
+        "field",
+        "item.published_at",
+        "item.symbols",
+        "item.title",
+        "text"
+      ],
+      "pagination": "none"
+    },
+    {
+      "operationId": "newsItemText",
+      "group": "news",
+      "action": "text",
+      "method": "get",
+      "path": "/v1/news/{id}/text",
+      "auth": true,
+      "summary": "Get a news item's text in blocks",
+      "params": [
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 10,
+          "example": 20,
+          "description": "Blocks per page"
+        },
+        {
+          "name": "max_chars",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 12000,
+          "example": 12000,
+          "description": "Unicode code points per page; a block is never split (the minimum is the largest block)"
+        },
+        {
+          "name": "cursor",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "WyIyMDI2LTEwLTI5VDIwOjMwOjA1LjEyMzQ1NloiLCI0YzFkOWU2Mi0zYjdhLTRmMmUtOGQxYy05ZTBhN2I2YzVkNGYiXQ",
+          "description": "`next_cursor` of the previous page (with the same filters); an altered or foreign cursor is a 400 `invalid_cursor`"
+        },
+        {
+          "name": "id",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "4c1d9e62-3b7a-4f2e-8d1c-9e0a7b6c5d4f",
+          "description": "News item id"
+        }
+      ],
+      "view": "table",
+      "rowsPath": "blocks",
+      "columns": [
+        "index",
+        "heading",
+        "text"
+      ],
+      "pagination": "top",
+      "allItemsPath": [
+        "blocks"
+      ]
+    },
     {
       "operationId": "institutionalOwnershipHoldingsByCompany",
       "group": "ownership",
@@ -4744,7 +5310,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Company ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -4989,7 +5555,7 @@
           "required": false,
           "type": "string",
           "example": "AAPL",
-          "description": "Company ticker symbol or CIK (at least one of cik or identifier required)",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404. At least one of cik or identifier is required.",
           "alias": "i"
         },
         {
@@ -5123,7 +5689,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {
@@ -5213,7 +5779,7 @@
           "required": true,
           "type": "string",
           "example": "AAPL",
-          "description": "Ticker symbol or CIK",
+          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
           "alias": "i"
         },
         {