News

Publisher stories with ticker links, topics and a twelve-hour delay.

One row is

Publisher stories with ticker links, topics and a twelve-hour delay

Example response

Trimmed real output. No key needed.

GET /v1/datasets/news/sample

Dates reflect the example, not current coverage.

{
  "data": {
    "items": [
      {
        "id": "53e3a32d-3f4d-5d49-a1aa-1e1835456d1c",
        "headline": "8-K - CAPITAL ONE MULTI ASSET EXECUTION TRUST (0001163321) (Filer)",
        "summary": "Filed: 2026-10-05 AccNo: 0001193125-26-413925 Size: 734 KB Item 8.01: Other Events Item 9.01: Financial Statements and Exhibits",
        "topic": "filing",
        "topics": [
          "filing"
        ],
        "sentiment": "neutral",
        "sectors": [],
        "scope": "single_ticker",
        "firstPublishedAt": "2026-10-05T18:11:19.000Z",
        "lastPublishedAt": "2026-10-05T18:11:19.000Z",
        "firstSeenAt": "2026-10-05T18:11:19.000Z",
        "lastSeenAt": "2026-10-05T18:11:19.000Z",
        "primaryUrl": "https://www.sec.gov/Archives/edgar/data/1163321/000119312526413925/0001193125-26-413925-index.htm",
        "primarySource": "sec-8k",
        "primaryPublisher": "SEC",
        "publishers": [
          "SEC"
        ],
        "scores": {
          "importance": 60,
          "urgency": 0,
          "marketImpact": 0,
          "novelty": 0,
          "confidence": 1
        },
        "flags": {
          "breaking": false,
          "developing": false,
          "provisional": false,
          "stale": false
        },
        "breaking": {
          "active": false,
          "provisional": false,
          "kind": null,
          "reason": null,
          "confidence": null,
          "firstDetectedAt": null,
          "lastMeaningfulAt": null,
          "confirmedAt": null,
          "expiresAt": null
        },
        "variantCount": 1,
        "sourceCount": 1,
        "sources": [
          "sec-8k"
        ],
        "tickerLinks": []
      },
      {
        "id": "fa03d949-4113-5c31-a10c-2e48b1363966",
        "headline": "8-K - CAPITAL ONE FUNDING, LLC (0001162387) (Filer)",
        "summary": "Filed: 2026-10-05 AccNo: 0001193125-26-413925 Size: 734 KB Item 8.01: Other Events Item 9.01: Financial Statements and Exhibits",
        "topic": "filing",
        "topics": [
          "filing"
        ],
        "sentiment": "neutral",
        "sectors": [],
        "scope": "single_ticker",
        "firstPublishedAt": "2026-10-05T18:11:19.000Z",
        "lastPublishedAt": "2026-10-05T18:11:19.000Z",
        "firstSeenAt": "2026-10-05T18:11:19.000Z",
        "lastSeenAt": "2026-10-05T18:11:19.000Z",
        "primaryUrl": "https://www.sec.gov/Archives/edgar/data/1162387/000119312526413925/0001193125-26-413925-index.htm",
        "primarySource": "sec-8k",
        "primaryPublisher": "SEC",
        "publishers": [
          "SEC"
        ],
        "scores": {
          "importance": 60,
          "urgency": 0,
          "marketImpact": 0,
          "novelty": 0,
          "confidence": 1
        },
        "flags": {
          "breaking": false,
          "developing": false,
          "provisional": false,
          "stale": false
        },
        "breaking": {
          "active": false,
          "provisional": false,
          "kind": null,
          "reason": null,
          "confidence": null,
          "firstDetectedAt": null,
          "lastMeaningfulAt": null,
          "confirmedAt": null,
          "expiresAt": null
        },
        "variantCount": 1,
        "sourceCount": 1,
        "sources": [
          "sec-8k"
        ],
        "tickerLinks": []
      },
      {
        "id": "357bac37-e47d-5fab-a6e4-a455ce209c1b",
        "headline": "8-K - SCWorx Corp. (0001674227) (Filer)",
        "summary": "Filed: 2026-10-05 AccNo: 0001213900-26-106749 Size: 224 KB Item 1.01: Entry into a Material Definitive Agreement Item 3.01: Notice of Delisting or Failure to Satisfy a Continued Listing Rule or Standard; Transfer of Listing Item 7.01: Regulation FD Disclosure Item 9.01: Financial Statements and Exhibits",
        "topic": "filing",
        "topics": [
          "filing",
          "reg"
        ],
        "sentiment": "neutral",
        "sectors": [],
        "scope": "single_ticker",
        "firstPublishedAt": "2026-10-05T17:08:55.000Z",
        "lastPublishedAt": "2026-10-05T17:08:55.000Z",
        "firstSeenAt": "2026-10-05T17:08:55.000Z",
        "lastSeenAt": "2026-10-05T17:08:55.000Z",
        "primaryUrl": "https://www.sec.gov/Archives/edgar/data/1674227/000121390026106749/0001213900-26-106749-index.htm",
        "primarySource": "sec-8k",
        "primaryPublisher": "SEC",
        "publishers": [
          "SEC"
        ],
        "scores": {
          "importance": 60,
          "urgency": 0,
          "marketImpact": 0,
          "novelty": 0,
          "confidence": 1
        },
        "flags": {
          "breaking": false,
          "developing": false,
          "provisional": false,
          "stale": false
        },
        "breaking": {
          "active": false,
          "provisional": false,
          "kind": null,
          "reason": null,
          "confidence": null,
          "firstDetectedAt": null,
          "lastMeaningfulAt": null,
          "confirmedAt": null,
          "expiresAt": null
        },
        "variantCount": 1,
        "sourceCount": 1,
        "sources": [
          "sec-8k"
        ],
        "tickerLinks": []
      },
      {
        "id": "be202899-5423-5124-a129-2707c2e3d91a",
        "headline": "8-K/A - STAAR SURGICAL CO (0000718937) (Filer)",
        "summary": "Filed: 2026-10-05 AccNo: 0001193125-26-413763 Size: 242 KB Item 5.02: Departure of Directors or Certain Officers; Election of Directors; Appointment of Certain Officers: Compensatory Arrangements of Certain Officers Item 7.01: Regulation FD Disclosure Item 9.01: Financial Statements and Exhibits",
        "topic": "filing",
        "topics": [
          "filing",
          "reg"
        ],
        "sentiment": "neutral",
        "sectors": [],
        "scope": "single_ticker",
        "firstPublishedAt": "2026-10-05T16:25:39.000Z",
        "lastPublishedAt": "2026-10-05T16:25:39.000Z",
        "firstSeenAt": "2026-10-05T16:25:39.000Z",
        "lastSeenAt": "2026-10-05T16:25:39.000Z",
        "primaryUrl": "https://www.sec.gov/Archives/edgar/data/718937/000119312526413763/0001193125-26-413763-index.htm",
        "primarySource": "sec-8k",
        "primaryPublisher": "SEC",
        "publishers": [
          "SEC"
        ],
        "scores": {
          "importance": 60,
          "urgency": 0,
          "marketImpact": 0,
          "novelty": 0,
          "confidence": 1
        },
        "flags": {
          "breaking": false,
          "developing": false,
          "provisional": false,
          "stale": false
        },
        "breaking": {
          "active": false,
          "provisional": false,
          "kind": null,
          "reason": null,
          "confidence": null,
          "firstDetectedAt": null,
          "lastMeaningfulAt": null,
          "confirmedAt": null,
          "expiresAt": null
        },
        "variantCount": 1,
        "sourceCount": 1,
        "sources": [
          "sec-8k"
        ],
        "tickerLinks": []
      }
    ],
    "nextCursor": null
  },
  "meta": {
    "dataset": "news",
    "asOf": "2026-10-05T18:11:19.000Z",
    "source": [
      {
        "id": "publisher-news",
        "attribution": "News publishers and public reports",
        "licence": "Use subject to Gloom Datasets terms"
      }
    ],
    "historyStarts": null,
    "coverage": {
      "stories": 4,
      "delaySeconds": 43200
    },
    "lastUpdated": "2026-10-05T18:11:19.000Z",
    "disclaimer": "Stories are delayed by 12 hours. Real-time news is a separate product."
  }
}

Routes

Base URL https://api.gloom.sh. Send a key with each call; the key's account needs a plan.

GET /v1/stories4 credits

Delayed publisher stories with ticker and topic filters. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameters18 rows
Parameter

feed

In

query

Type

latest, top, breaking, ticker, sector, topic

Parameter

tickers

In

query

Type

string

Parameter

tickerTier

In

query

Type

primary, related, any

Parameter

tickerRelations

In

query

Type

string

Parameter

topics

In

query

Type

string

Parameter

categories

In

query

Type

string

Parameter

sectors

In

query

Type

string

Parameter

sources

In

query

Type

string

Parameter

excludeSources

In

query

Type

string

Parameter

sentiment

In

query

Type

positive, neutral, negative

Parameter

minImportance

In

query

Type

integer 0 to 100

Parameter

minUrgency

In

query

Type

integer 0 to 100

Parameter

breaking

In

query

Type

boolean

Parameter

since

In

query

Type

string ^\d{4}-\d{2}-\d{2}(?:T[0-9:.]+Z)?$

Notes

Calendar date or UTC timestamp.

Parameter

until

In

query

Type

string ^\d{4}-\d{2}-\d{2}(?:T[0-9:.]+Z)?$

Notes

Calendar date or UTC timestamp.

Parameter

query

In

query

Type

string

Parameter

cursor

In

query

Type

string

Parameter

limit

In

query

Type

integer 1 to 100

  • Credits: 4 (search x2)
  • Plans: Basic, Desk, Enterprise
GET /v1/stories/sources2 credits

News source directory. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameters: none.

  • Credits: 2 (lookup x2)
  • Plans: Basic, Desk, Enterprise
GET /v1/stories/facets2 credits

Delayed story topic, sector and source counts. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameters: none.

  • Credits: 2 (lookup x2)
  • Plans: Basic, Desk, Enterprise
GET /v1/stories/{id}10 credits

Delayed story and its publisher variants. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter

id

In

path, required

Type

string

  • Credits: 10 (evidence x2)
  • Plans: Basic, Desk, Enterprise

Meta fields

Field

dataset

Here

The dataset id

In the example

"news"

Field

asOf

Here

The observation date established by the service; otherwise null

In the example

"2026-10-05T18:11:19.000Z"

Field

source

Here

Attribution and usage terms of each source

In the example

1 source

Field

historyStarts

Here

Earliest stored history when established by the service; otherwise null.

In the example

null, not stated yet

Field

coverage

Here

Service-established coverage; null when unavailable.

In the example

{"stories":4,"delaySeconds":43200}

Field

lastUpdated

Here

The source update time established by the service; otherwise null

In the example

"2026-10-05T18:11:19.000Z"

Sources

Source

News publishers and public reports

Usage terms

Use subject to Gloom Datasets terms

Errors

These routes can answer 400, 401, 402, 403, 404, 429, 503. See Errors for the codes.

Gloom Datasets reads stored data only: a call never starts a collection.