Use below GET endpoints to obtain ticker and general market news. To further refine and filter news results use our STRING parameters.
GET Company Ticker News
Use this endpoint to obtain news for one ticker. In this example "FB" is the ticker for Facebook.
If you want to retrieve news for multiple tickers separate them with a comma.
GET General Market News
Use below endpoint to retrieve General Market News.
GET Tickers DB
Use below endpoint to view all tickers in our Database. This endpoint can be accessed once per day (non-trial).
STRING Default Parameters
Number of news items returned. Items value must be between 1 and 50. This parameter is required.
Use below parameter if you would like to download the data as a .csv file.
STRING Filter on News Sources
Use below parameters if you want to filter on news sources. Use a comma if you would like to include/exclude multiple news sources. To view the list of all news sources: Click here
STRING Filter on Type
Use below parameters if you only would like to retrieve video or article news.
STRING Filter on Sentiment
Use this parameter if you would like to filter only on neutral, positive or negative news.
STRING Sort by Rank
Use this parameter if you would like to sort by importance. This parameter uses our rank score algorithm. Sort by Rank is only compatible with Company Ticker News endpoint. It provides a better user experience for sites and apps. Adding &days will sort by rank but for the last X days.
By default our news is sorted by date (newest first). If you would like to showcase oldest news first, use below parameter:
STRING Optional Parameters
Use these parameters if you would like to retrieve News ID or Event ID field on the GET response.
Use below parameter if you would like to retrieve our rank score.
You can also combine extra-fields parameters.
For more advanced features use below endpoints and parameters.
GET All Ticker News
If you want to retrieve all the news published under All tickers, use below endpoint.
GET Top Mentioned Stocks
Retrieve the top 10 most mentioned tickers. Use the &date= parameter to specify your desired date range.
GET Sentiment Analysis
Retrieve the daily sentiment of Tickers and General Market News. Use the &date= Parameter to specify your desired date range. For Individual tickers use below endpoint:
For All Tickers use below endpoint.
For General Market News use below endpoint.
Retrieve the latest news events and eventIDs. Events are important headlines that are receiving a significant amount of news coverage.
Add &eventid= to retrieve all news item from a specific event:
STRING Filter on Date, Time and IPO
Use the date parameters to obtain historical news (up to March 2019). Please use the following format: MMDDYYY. You can also use: last5min, last10min, last15min, last30min, last45min, last60min, today, yesterday, last7days, last30days, last60days, last90days, yeartodate.
If you want to obtain news from companies that went public on a specific date/year use below parameter:
Filter on exact time. The format is hours, minutes and seconds - HHMMSS. This parameter is only compatible with &date parameter.
STRING Filter on Sectors & Industries
These parameter are only valid with the GET All Ticker News. Use it to filter on specific sectors: Click here
Use this parameter to filter topics. To view the available topics: Click here
Topics "cannabis" AND "oil".
Topics "cannabis" OR "oil".
Exclude the Topic "product" and "pressrelease".
Or you can use your own Keywords:
Search keywords "Elon Musk" AND "Zuckerberg".
Search keywords "Elon Musk" OR "Zuckerberg".
STRING More News Results & Fallback Option
Use the page parameter if you would like to obtain more than 50 news results.
If a specific ticker doesn't have any news associated with it you can use the fallback parameter to obtain general market news. This parameter is useful for sites and apps to avoid showing empty responses to users.
Premium | Business
If you have any feedback or questions, don't hesitate to contact us.
&topic=CEO News related to CEO's.
&topic=CFO News related to CFO's.
&topic=COO News related to COO's.
&topic=callscript Conference call transcripts.
&topic=Class+Action+Lawsuit Class Action Lawsuit.
&topic=conference Conference Announcements.
&topic=pressrelease Press Releases.
&topic=Shareholder+Alert Shareholder Alert.
&topic=cannabis Cannabis related news.
&topic=cramer Jim Cramer.
&topic=dividend Dividend related news.
&topic=earnings News related to earnings.
&topic=gold News related to Gold.
&topic=madmoney Mad Money.
&topic=manda News on Mergers and Acquistions.
&topic=oil News related to Oil industry.
&topic=paywallPaid content behind a paywall.
&topic=paylimitwallArticle with view limit (e.g. max 3 articles per day).
&topic=political Political Tinted Content.
&topic=product Product Related news.
&topic=Real+Estate News about Real Estate and REIT ETFs
&topic=SPAC News about SPACs.
&topic=tanalysis Technical Analysis articles.
&topic=wbuffett Warren Buffet.
24/7 Wall Street
Bloomberg Markets and Finance (video)
Bloomberg Technology (video)
CNBC International TV
Digital Trends (video)
Discount The Obvious
Globe News Wire
Investors Business Daily
New York Times
New York Post
OTC PR Wire
See It Market
The Dog of Wall Street
The Motley Fool
The Street (video)
The Verge (video)
Wall Street Journal (video)
Yahoo Finance (video)
Zacks Investment Research
§or=Basic+Materials Basic Materials
§or=Consumer+Goods Consumer Goods
§or=Industrial+Goods Industrial Goods
&country=British+Virgin+Islands British Virgin Islands