The Earnings Calendar API provides access to earnings results and upcoming earning dates for all major companies.
https://api.api-ninjas.com/v1/earningscalendar
Returns a list of past earnings results and upcoming earnings dates for any given ticker symbol. Returns 3 earnings results unless the limit parameter is set.
ticker requiredCompany ticker symbol (e.g., MSFT).
show_upcoming optionalWhether to show upcoming earnings dates. Must be either true or false. If unset, the default value is false.
limit optional Premium OnlyHow many results to return. Must be between 1 and 100 (inclusive).
X-Api-Key requiredAPI Key associated with your account.
https://api.api-ninjas.com/v1/earningscalendar?ticker=MSFTHeaders
X-Api-KeyLog in or sign up to get your API Key1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
[
{
"pricedate": "2024-07-30",
"ticker": "MSFT",
"actual_eps": 2.95,
"estimated_eps": 2.93,
"actual_revenue": 64727000000,
"estimated_revenue": 64382224966
},
{
"pricedate": "2024-04-25",
"ticker": "MSFT",
"actual_eps": 2.94,
"estimated_eps": 2.82,
"actual_revenue": 61858000000,
"estimated_revenue": 60861823613
},
{
"pricedate": "2024-01-30",
"ticker": "MSFT",
"actual_eps": 2.93,
"estimated_eps": 2.78,
"actual_revenue": 62020000000,
"estimated_revenue": 56239300000
}
]1
2
3
4
5
6
7
8
import requests
symbol = 'MSFT'
api_url = 'https://api.api-ninjas.com/v1/earningscalendar?ticker={}'.format(symbol)
response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'})
if response.status_code == requests.codes.ok:
print(response.text)
else:
print("Error:", response.status_code, response.text)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.