Stock News API
The Stock News API returns the latest stock-market news headlines aggregated from major financial publishers (CNBC, MarketWatch, Yahoo Finance, Benzinga, Seeking Alpha, Nasdaq, Forbes, the Wall Street Journal, SEC EDGAR, and more). Filter by one or more tickers, paginate through results, and always get the most recent news first.
From 4,522 users
Applications using this API
API Status
API Response Times
Average | P50 | P75 | P90 | P95 |
|---|---|---|---|---|
| 366ms | 385ms | 459ms | 601ms | 1127ms |
Similar APIs
Didn't find what you were looking for? Suggest an improvement
/v1/stocknews GET Premium Only
https://api.api-ninjas.com/v1/stocknews
Returns up to 50 of the most recent stock-market news headlines, sorted most recent first. Use the optional ticker parameter to filter by one or more symbols. This endpoint is available to premium subscribers only.
Parameters
tickeroptionalSingle ticker (e.g.
AAPL) or a comma-separated list (e.g.AAPL,MSFT,TSLA). When omitted, the latest news across all publishers is returned.offsetoptionalPagination offset. Each page returns 50 results. Defaults to
0. Maximum10000.dateoptionalFilter to a single calendar day (UTC). Format
YYYY-MM-DD. Mutually exclusive withstart_date/end_date.start_dateoptionalInclusive lower bound on the article's published date (UTC). Format
YYYY-MM-DD.end_dateoptionalInclusive upper bound on the article's published date (UTC). Format
YYYY-MM-DD.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
A JSON array of up to 50 headline objects, each with the following fields, or an error if the request is unsuccessful.
titleHeadline of the article.
urlCanonical URL of the article.
sourceCanonical publisher slug (e.g.
cnbc,benzinga,marketwatch).publishedUnix timestamp (in seconds) of when the article was published.
tickersArray of ticker symbols associated with the article.
authorArticle author, when available. May be
null.
Sample Request Live Demo!
https://api.api-ninjas.com/v1/stocknews?ticker=AAPLHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
Code Examples
1
2
curl -X GET "https://api.api-ninjas.com/v1/stocknews?ticker=AAPL" \
-H "X-Api-Key: YOUR_API_KEY"If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.
Frequently Asked Questions
Can I use the Stock News API for commercial purposes?
Yes, but you must have a premium subscription. Commercial use of the Stock News API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.How do I get an API key and start using the Stock News API?
Sign up for a free account to instantly get your API key, then pass it in theX-Api-Keyheader on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.What happens if I exceed my quota for the month?
Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.What happens if a request to the Stock News API fails?
The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.What are some use cases for the Stock News API?
It powers ticker-specific news feeds, sentiment and event-driven trading signals, and research dashboards, returning headlines aggregated from major publishers like CNBC, MarketWatch, Yahoo Finance, Benzinga, and the Wall Street Journal. Pair it with the Stock Price or Earnings APIs to correlate news with price moves and reporting dates.How do I filter news to a specific company or date range?
Pass thetickerparameter with a single symbol (e.g.AAPL) or a comma-separated list (e.g.AAPL,MSFT,TSLA); omit it to get the latest news across all publishers. To narrow by time, usedatefor a single UTC day inYYYY-MM-DDformat, or thestart_date/end_datepair for an inclusive range, and resolve symbols first with the Ticker API if needed.What fields does each news item in the response include?
Each headline object includestitle, the canonical articleurl, a publishersourceslug (e.g.cnbc,benzinga), apublishedUnix timestamp in seconds, atickersarray of associated symbols, and anauthorfield that may benull. See error codes for the response returned when a request is unsuccessful.How many results are returned and how do I paginate?
This is a Premium-only endpoint that returns up to 50 of the most recent headlines sorted newest first; use theoffsetparameter (default0, maximum10000) to page through additional results in increments of 50. See pricing for premium access details, or browse the full catalog at API Ninjas APIs.