News & Stories

Source-linked stories with cursor or offset pagination, filters, and field shaping.

Generated page

This page is generated from the published OpenAPI schema. Do not edit it by hand — run npm run generate:api.

GET /v1/news

News stories

Returns source-linked stories with cursor or offset pagination, filters, field shaping, and normalized metadata.

API key required

Query parameters

Name	Required	Description	Example
page	no	Page number, starting at 1.	1
page_size	no	Stories per page. Alias: limit. Maximum 100.	50
cursor	no	Opaque cursor returned as page.next_cursor for the next page.	eyJvZmZzZXQiOjUwfQ
offset	no	Zero-based offset. Ignored when cursor is supplied.	100
fields	no	Comma-separated response fields to return. The id field is always included when present.	id,title,publishedAt,impactPaths
include	no	Comma-separated detail groups. Use full for all fields, or sources,claims,impactDetails,body for selected heavy fields.	sources,claims
sort	no	Feed order: pipeline for newest stories or popular for 12-hour freshness-bucketed popularity.	popular
country	no	G20 country filter from the story passive entities.	Japan
category	no	Normalized Neural Ledger story category.	Trading & Markets
entity	no	Passive entity text or id filter.	Federal Reserve
impact_path	no	Impact path text, id, or lookup token filter.	oil
tag	no	Normalized story tag filter.	tariff
q	no	Full-text query across titles, summaries, entities, tags, and impact paths.	tariff
published_since	no	Return stories published at or after this ISO date/time.	2026-05-01T00:00:00Z
published_until	no	Return stories published at or before this ISO date/time.	2026-05-31T23:59:59Z
updated_since	no	Return stories updated at or after this ISO date/time.	2026-05-01T00:00:00Z
updated_until	no	Return stories updated at or before this ISO date/time.	2026-05-31T23:59:59Z

Example

curl -sS "https://theneuralledger.com/v1/news?page=1&page_size=50&cursor=eyJvZmZzZXQiOjUwfQ" \
  -H "Authorization: Bearer $TNL_API_KEY"

Responses

Status	Meaning
200	Successful response.
401	Missing or invalid API key.
429	Monthly API call limit exceeded.

GET /v1/news-stories

News stories alias

Alias of /v1/news for clients that use the upstream story naming convention.

API key required

Query parameters

Name	Required	Description	Example
page	no	Page number, starting at 1.	1
page_size	no	Stories per page. Alias: limit. Maximum 100.	50
cursor	no	Opaque cursor returned as page.next_cursor for the next page.	eyJvZmZzZXQiOjUwfQ
offset	no	Zero-based offset. Ignored when cursor is supplied.	100
fields	no	Comma-separated response fields to return. The id field is always included when present.	id,title,publishedAt,impactPaths
include	no	Comma-separated detail groups. Use full for all fields, or sources,claims,impactDetails,body for selected heavy fields.	sources,claims
sort	no	Feed order: pipeline for newest stories or popular for 12-hour freshness-bucketed popularity.	popular
country	no	G20 country filter from the story passive entities.	Japan
category	no	Normalized Neural Ledger story category.	Trading & Markets
entity	no	Passive entity text or id filter.	Federal Reserve
impact_path	no	Impact path text, id, or lookup token filter.	oil
tag	no	Normalized story tag filter.	tariff
q	no	Full-text query across titles, summaries, entities, tags, and impact paths.	tariff
published_since	no	Return stories published at or after this ISO date/time.	2026-05-01T00:00:00Z
published_until	no	Return stories published at or before this ISO date/time.	2026-05-31T23:59:59Z
updated_since	no	Return stories updated at or after this ISO date/time.	2026-05-01T00:00:00Z
updated_until	no	Return stories updated at or before this ISO date/time.	2026-05-31T23:59:59Z

Example

curl -sS "https://theneuralledger.com/v1/news-stories?page=1&page_size=50&cursor=eyJvZmZzZXQiOjUwfQ" \
  -H "Authorization: Bearer $TNL_API_KEY"

Responses

Status	Meaning
200	Successful response.
401	Missing or invalid API key.
429	Monthly API call limit exceeded.

GET /v1/news/{idOrSlug}

Single story

Returns one story by story id or the title slug used by article pages.

API key required

Path parameters

Name	Required	Description	Example
idOrSlug	yes	Story id, title slug, entity value, impact path value, ticker, or saved-search id depending on the endpoint.	—

Query parameters

Name	Required	Description	Example
fields	no	Comma-separated response fields to return.	id,title,publishedAt,sources
include	no	Detail groups to include when not returning a full story.	sources,claims

Example

curl -sS "https://theneuralledger.com/v1/news/example-slug?fields=id%2Ctitle%2CpublishedAt%2Csources&include=sources%2Cclaims" \
  -H "Authorization: Bearer $TNL_API_KEY"

Responses

Status	Meaning
200	Successful response.
401	Missing or invalid API key.
429	Monthly API call limit exceeded.

GET /v1/news-stories/{idOrSlug}

Single story alias

Alias of /v1/news/{id-or-slug} for story-oriented clients.

API key required

Path parameters

Name	Required	Description	Example
idOrSlug	yes	Story id, title slug, entity value, impact path value, ticker, or saved-search id depending on the endpoint.	—

Query parameters

Name	Required	Description	Example
fields	no	Comma-separated response fields to return.	id,title,publishedAt,sources
include	no	Detail groups to include when not returning a full story.	sources,claims

Example

curl -sS "https://theneuralledger.com/v1/news-stories/example-slug?fields=id%2Ctitle%2CpublishedAt%2Csources&include=sources%2Cclaims" \
  -H "Authorization: Bearer $TNL_API_KEY"

Responses

Status	Meaning
200	Successful response.
401	Missing or invalid API key.
429	Monthly API call limit exceeded.