![](https://eodhd.com/financial-apis/wp-content/uploads/2024/04/financial-news-feed-API-EODHD-1.png)
Add our financial news aggregation and in-house sentiment analysis to your project with just one line of code. Our system continuously analyzes the most crucial financial news portals, providing you with access to constantly updated news data and generating daily sentiment scores for stocks, ETFs, Forex, and Cryptocurrencies based on positive and negative mentions.
For trading enthusiasts and data analysts, a finance news feed could be a valuable addition to essential fundamental and historical data (find more information in our financial data API documentation), especially when bundled together as one package from the same provider of market data APIs.
Available with: All-In-One, EOD Historical Data — All World, EOD+Intraday — All World Extended and Fundamentals Data Feed packages.
Consumption: Each request consumes 5Â API calls.
Quick jump:
Financial News API
In short, our Financial News API is a powerful yet simple tool that helps you access company news and filter them by date, news type, and specific tickers using given parameters.
News API could be tested with “demo” API key which works for AAPL.US ticker only. Here is the example:
https://eodhd.com/api/news?s=AAPL.US&offset=0&limit=10&api_token=demo&fmt=json
curl --location "https://eodhd.com/api/news?s=AAPL.US&offset=0&limit=10&api_token=demo&fmt=json"
$curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://eodhd.com/api/news?s=AAPL.US&offset=0&limit=10&api_token=demo&fmt=json', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'GET', )); $data = curl_exec($curl); curl_close($curl); try { $data = json_decode($data, true, 512, JSON_THROW_ON_ERROR); var_dump($data); } catch (Exception $e) { echo 'Error. '.$e->getMessage(); }
import requests url = f'https://eodhd.com/api/news?s=AAPL.US&offset=0&limit=10&api_token=demo&fmt=json' data = requests.get(url).json() print(data)
library(httr) library(jsonlite) url <- 'https://eodhd.com/api/news?s=AAPL.US&offset=0&limit=10&api_token=demo&fmt=json' response <- GET(url) if (http_type(response) == "application/json") { content <- content(response, "text", encoding = "UTF-8") cat(content) } else { cat("Error while receiving data\n") }
Financial News API parameters
- s: String. REQUIRED if parameter ‘t’ is not set. The ticker code to get news for.
- t: String. REQUIRED if parameter ‘s’ is not set. The tag to get news on a given topic. The list of supported topics you can find at the bottom of this page:
- api_token: String. REQUIRED. Your api_token to access the API. You will get it after registration.
- from and to – the format is ‘YYYY-MM-DD’. If you need data from Mar 1, 2021, to Mar 10, 2021, you should use from=2021-03-01 and to=2021-03-10.
- limit: Number. OPTIONAL. The number of results should be returned with the query. Default value: 50, minimum value: 1, maximum value: 1000.
- offset: Number. OPTIONAL. The offset of the data. Default value: 0, minimum value: 0. For example, to get 100 symbols starting from 200 you should use limit=100 and offset=200.
Financial News API output
The output provided in JSON contains the following fields:
- date. The date and time of the article are in ISO 8601 format.
- title. The title of the article.
- content. The full body of the article.
- link. The link to the source.
- symbols. The array of ticker symbols is mentioned in the article.
![Financial News API](https://eodhistoricaldata.com/financial-apis/wp-content/uploads/2021/03/image.png)
List of Supported Tags for Financial News
We have more than 50 tags to get news for a given topic, this list is expanding, below you can find all recommended tags in alphabetic order:
'balance sheet', 'capital employed', 'class action', 'company announcement', 'consensus eps estimate', 'consensus estimate', 'credit rating', 'discounted cash flow', 'dividend payments', 'earnings estimate', 'earnings growth', 'earnings per share', 'earnings release', 'earnings report', 'earnings results', 'earnings surprise', 'estimate revisions', 'european regulatory news', 'financial results', 'fourth quarter', 'free cash flow', 'future cash flows', 'growth rate', 'initial public offering', 'insider ownership', 'insider transactions', 'institutional investors', 'institutional ownership', 'intrinsic value', 'market research reports', 'net income', 'operating income', 'present value', 'press releases', 'price target', 'quarterly earnings', 'quarterly results', 'ratings', 'research analysis and reports', 'return on equity', 'revenue estimates', 'revenue growth', 'roce', 'roe', 'share price', 'shareholder rights', 'shareholder', 'shares outstanding', 'split', 'strong buy', 'total revenue', 'zacks investment research', 'zacks rank'
Financial News Sentiment Data API
This API provides sentiment analysis for news feeds related to specified tickers (stocks, cryptocurrencies, ETFs, etc.), returning sentiment scores – negative/positive weights – for specific dates.
Here is an example request for btc-usd.cc and AAP.US tickers:
https://eodhd.com/api/sentiments?s=btc-usd.cc,aapl.us&from=2022-01-01&to=2022-04-22&api_token=demo&fmt=json
curl --location "https://eodhd.com/api/sentiments?s=btc-usd.cc,aapl.us&from=2022-01-01&to=2022-04-22&api_token=demo&fmt=json"
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://eodhd.com/api/sentiments?s=btc-usd.cc,aapl.us&from=2022-01-01&to=2022-04-22&api_token=demo&fmt=json',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
));
$data = curl_exec($curl);
curl_close($curl);
try {
$data = json_decode($data, true, 512, JSON_THROW_ON_ERROR);
var_dump($data);
} catch (Exception $e) {
echo 'Error. '.$e->getMessage();
}
import requests
url = f'https://eodhd.com/api/sentiments?s=btc-usd.cc,aapl.us&from=2022-01-01&to=2022-04-22&api_token=demo&fmt=json'
data = requests.get(url).json()
print(data)
library(httr)
library(jsonlite)
url <- 'https://eodhd.com/api/sentiments?s=btc-usd.cc,aapl.us&from=2022-01-01&to=2022-04-22&api_token=demo&fmt=json'
response <- GET(url)
if (http_type(response) == "application/json") {
content <- content(response, "text", encoding = "UTF-8")
cat(content)
} else {
cat("Error while receiving data\n")
}
Sentiment Data API parameters
- s. [REQUIRED]. parameter to your URL and you will be able to get data for multiple tickers at one request, all tickers should be separated with a comma. Check the list of supported exchanges to get more information about the stock markets we do support.
- api_token. [REQUIRED]. your own API KEY, which you will get after you subscribe to our services.
- from and to. [OPTIONAL] – the format is ‘YYYY-MM-DD’. If you need data from Jan 5, 2022 to Feb 10, 2022, you should use from=2022-01-05 and to=2022-02-10.
Sentiment Data API Output
The output for sentiment data financial API is divided by ticker codes used with “s=” parameter. Please note that tickers codes are normalized in the output.
- date. The date of sentimental data aggregation.
- count. The number of news used for data aggregation.
- normalized. The sentiment score is based on negative and positive mentions normalized with possible values [-1;1].
![Sentimental Data Financial API](https://eodhistoricaldata.com/financial-apis/wp-content/uploads/2022/04/image-2.png)
Let’s make the API better together
As one of the best providers of stock market APIs, we are constantly striving to improve our service. We welcome any feedback and are ready to add new fields and signals to our Financial News API based on your interests. Simply send us an email at [email protected].