Company news
Get every article about one company, newest first, including news for all
of its listings. Pass NASDAQ:AAPL, a ticker ID, or a FIGI. To find one,
search tickers or
retrieve a ticker.
An article that names several companies appears in each of their feeds with
the same id, so you can drop duplicates.
/v3.0.0/news/{identifier}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
curl "https://api.roic.ai/v3.0.0/news/NASDAQ:AAPL?apikey=YOUR_API_KEY&limit=2"{
"data": [
{
"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": null,
"previous_page_url": null
}Parameters
Path parameters
identifierstringrequiredA ticker ID, an exchange and symbol separated by a colon (e.g. NASDAQ:AAPL), or a FIGI.
NASDAQ:AAPLtkr_cO46h8pgSu9QqyBBG000B9XRY4Query parameters
published_atstringoptionalFilter 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- Hide filter modifiers
published_at.gtestringReturn news published at or after the given time.
published_at.gtstringReturn news published strictly after the given time.
published_at.ltestringReturn news published at or before the given time.
published_at.ltstringReturn news published strictly before the given time.
limitintegeroptionalMaximum number of resources to return.
25Min: 1Max: 100pagestringoptionalToken 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 objectsArray of news articles for the current page, newest first.
+ Show child attributes- Hide child attributes
idstringUnique 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.
titlestringHeadline of the article.
summarystringTeaser 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.
urlstringLink to the full article on the publisher's site.
sitestringDomain of the publisher, for example wsj.com. null when the publisher is unknown.
image_urlnullableLink to the main image of the article, or null when it has none.
symbolsarray of stringsCompanies 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_atstringTime the article was published, as an ISO 8601 UTC timestamp with milliseconds. Results sort on this field, newest first.
next_page_urlnullableURL of the next page of results, or null when there are no more pages. Request it unchanged to continue paging.
previous_page_urlnullableURL 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:
| Status | code | When it happens |
|---|---|---|
| 400 | invalid_date_range | The lower published_at bound is later than the upper bound. |
| 402 | historical_data_restricted | A published_at bound is older than the history of your plan. |