List news

Get the latest news on listed companies across the market, newest first. Each article comes with a headline, a summary, a link to the full story, and the tickers it names.

For one company, use Company news.

GET/v3.0.0/news

Plan Access

Free

(Your plan)

Individual

$29/mo

Professional

$89/mo

Plan History

Free

(Your plan)

2 years

Individual

$29/mo

5 years

Professional

$89/mo

All available

Request
curl "https://api.roic.ai/v3.0.0/news?apikey=YOUR_API_KEY&limit=3"
Response
200 OK
{
  "data": [
    {
      "id": "news_R4tWm9QeXc2LbN",
      "title": "Nvidia Guides Fourth-Quarter Revenue Above Estimates as Data Center Sales Climb",
      "summary": "Nvidia expects fourth-quarter revenue of $65 billion, ahead of analyst estimates, as demand for its data center chips keeps growing.",
      "url": "https://www.roic.ai/news/nvidia-guides-fourth-quarter-revenue-above-estimates",
      "site": "roic.ai",
      "image_url": "https://www.roic.ai/img/news/nvidia-guides-fourth-quarter-revenue.webp",
      "symbols": [
        "NASDAQ:NVDA"
      ],
      "published_at": "2026-11-11T14:05:12.318Z"
    },
    {
      "id": "news_3f9a1c7e5b2d8046a1e9c3b7",
      "title": "Apple and Alphabet Extend Search Agreement Through 2030",
      "summary": "The companies agreed to keep Google as the default search engine in Safari, with new revenue-sharing terms.",
      "url": "https://www.example-markets.com/tech/apple-alphabet-search-agreement-2030",
      "site": "example-markets.com",
      "image_url": null,
      "symbols": [
        "NASDAQ:AAPL",
        "NASDAQ:GOOGL"
      ],
      "published_at": "2026-11-11T13:51:40.000Z"
    },
    {
      "id": "news_b81d4e09c6a2f75e3d0c94a8",
      "title": "Apple Supplier Shares Rise on Strong iPhone Holiday Orders",
      "summary": null,
      "url": "https://www.example-markets.com/markets/apple-supplier-iphone-orders",
      "site": "example-markets.com",
      "image_url": "https://www.example-markets.com/images/apple-supplier-orders.jpg",
      "symbols": [
        "NASDAQ:AAPL"
      ],
      "published_at": "2026-11-11T13:20:07.000Z"
    }
  ],
  "next_page_url": "/v3.0.0/news?limit=3&page=page_v1_k1_Tq8Lm2Xw9RvB...",
  "previous_page_url": null
}

Parameters

Query parameters

published_atstringoptional

Filter by publication time with the modifiers below. Each modifier takes an ISO 8601 timestamp with Z or a UTC offset, for example 2026-11-11T13:42:18.412Z.

+ Show filter modifiers
published_at.gtestring

Return news published at or after the given time.

published_at.gtstring

Return news published strictly after the given time.

published_at.ltestring

Return news published at or before the given time.

published_at.ltstring

Return news published strictly before the given time.

limitintegeroptional

Maximum number of resources to return.

Default: 25Min: 1Max: 100
pagestringoptional

Token to request the next page of data. Each response returns ready-made next_page_url and previous_page_url (null on the last and first page, respectively) that repeat your filters with this token. They are relative and carry no credentials: prefix the API host and pass apikey separately, or keep sending your Authorization header.

Response

Each article appears once, with all referenced companies in symbols. url links to the full article, site is the publisher's domain, and summary is the article's teaser. The API does not return full article text.

Each object in data is an article. Results sort by published_at, newest first. Articles with the same published_at keep a fixed order between requests. Follow next_page_url unchanged to page back through older articles.

Response fields

dataarray of objects

Array of news articles for the current page, newest first.

+ Show child attributes
idstring

Unique identifier of the article, beginning with news_. Treat it as opaque. It never changes, and an article has the same id in List news and Company news, so you can use it to drop duplicates.

titlestring

Headline of the article.

summarystring

Teaser of the article in plain text, or null when the article has none. It can run to a few paragraphs. The API does not return the full article text.

urlstring

Link to the full article on the publisher's site.

sitestring

Domain of the publisher, for example wsj.com. null when the publisher is unknown.

image_urlstring

Link to the main image of the article, or null when it has none.

symbolsarray of strings

Companies the article references, in alphabetical order. Each entry is a qualified symbol that combines the exchange code and the ticker with a colon, for example NASDAQ:AAPL. One article can reference several companies. The array is empty when the article references no listed company.

published_atstring

Time the article was published, as an ISO 8601 UTC timestamp with milliseconds. Results sort on this field, newest first.

next_page_urlstring

URL of the next page of results, or null when there are no more pages. Request it unchanged to continue paging.

previous_page_urlnullable

URL of the previous page of results, or null on the first page.

Errors

Errors use the standard v3 error envelope. This endpoint also returns these codes:

StatuscodeWhen it happens
400invalid_date_rangeThe lower published_at bound is later than the upper bound.
402historical_data_restrictedA published_at bound is older than the history of your plan.