Create TeamAdd Your APIDocs
Log In
Sign Up

Seeking Alpha

FREEMIUM
Verified
✓
By Api Dojo | Updated hace 16 días | Finance
Popularity

9.9 / 10

Latency

1,797ms

Service Level

100%

Health Check

N/A

Back to All Discussions

How can I get upcoming earning dates? (Cannot find in get_earnings)

Rapid account: Statsoftthill
statsoftthill
hace 25 días

Any idea where I can find the upcoming earning dates for a symbol? It is available interactively at the SeekingAlpha site (e.g., https://seekingalpha.com/symbol/NVDA/earnings).

The symbols/get-earnings endpoint only gives me valid effective dates for past earnings

Rapid account: Apidojo
apidojo Commented hace 16 días

Hello,
I will have my teammate edit the document.
Regards.

Rapid account: Statsoftthill
statsoftthill Commented hace 16 días

apidojo: You wrote: “*SA does not support multiple symbols for that feature. *”

OK; fair enough: Please correct the documentation then, i.e., below the respective field symbol it says:

*REQUIRED: Symbol to query for data. **Separating by comma to query multiple symbols at once, ex : aapl,tsla***

See also screenshot here: https://drive.google.com/file/d/12CY0x4_EHViRtgazx_7ovT24Bc0n036t/view?usp=sharing

Rapid account: Apidojo
apidojo Commented hace 17 días

I am sorry No, it isn’t. SA does not support multiple symbols for that feature. That is why the parameter is symbol (not symbols)

Regards.

Rapid account: Statsoftthill
statsoftthill Commented hace 17 días

Fantastic! Thank you apidojo !

BUT: One followup question: I cannot make the multiple-symbol query work; tried AAPL,TSLA or aapl,tsla (as in example given), or AAPL TSLA (no comma), …

For exampe, typing AAPL,TSLA into the interactive test UI at RapidAPI yields:

*conn.request(“GET”, “/symbols/get-estimated-earning-announces?symbol=AAPL%2CTSLA”, headers=headers)

always results in:

and always results in:
{
“AAPL,TSLA”: {
“releasedate”: null,
“releasetime”: null
}
}

Each individual symbol works great. I have a list of symbols to check (and must manage limited API-calls-resources…).

Again; REALLY appreciate your support! Invaluable!

Rapid account: Apidojo
apidojo Commented hace 18 días

Hello,

Please use this endpoint …/symbols/get-estimated-earning-announces?symbol=AAPL

Regards.

Rapid account: Statsoftthill
statsoftthill Commented hace 18 días

Hello @apidojo

You ask “Please circle the required data in the provided link so I can know which exact data you are looking for.”:

For past earnings dates, e.g., for NVDA Q4 earnings announced on 2/21/2024 (see https://seekingalpha.com/symbol/NVDA/earnings; see also screenshot here: https://drive.google.com/file/d/1goq0dLISDGpawDU40DifU1L1C90Z_-MF/view?usp=sharing) the API returns:

“eps_normalized_actual”: {
“0”: [
{
“effectivedate”: “2024-02-21T21:20:00.000-05:00”,
“dataitemvalue”: “5.16”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 4,
“fiscalyear”: 2024,
“calendarquarter”: 4,
“calendaryear”: 2023,
“periodenddate”: “2024-01-31T00:00:00.000-05:00”,

“advancedate”: “2024-02-21T21:20:00.000-05:00”

}

For the next earnings date expected on 5/22/24 (see https://seekingalpha.com/symbol/NVDA/earnings), I see:

“1”: [
{
“effectivedate”: “2024-03-22T07:49:46.000-04:00”,
“dataitemvalue”: “5.12966”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 1,
“fiscalyear”: 2025,
“calendarquarter”: 1,
“calendaryear”: 2024,
“periodenddate”: “2024-04-30T00:00:00.000-04:00”,

“advancedate”: null

}

Again, interactive SeekingAlpha (and Yahoo, FinnHub, Zacks, …) all report 5/22/24 as the next earnings date (estimated).

Obviously, when trading options it is critical to know those dates…, and the info is available on SeekingAlpha; see: https://drive.google.com/file/d/1goq0dLISDGpawDU40DifU1L1C90Z_-MF/view?usp=sharing.

Rapid account: Apidojo
apidojo Commented hace 19 días

Hello,

Please circle the required data in the provided link so I can know which exact data you are looking for.

Regards.

Rapid account: Statsoftthill
statsoftthill Commented hace 19 días

I carefully reviewed the response for NVDA (ID: 1150), for relative_periods=-3,-2,-1,0,1,2,3; results are below; just cannot see the earning dates. Am I missing something? Where is the upcoming estimated earnings date (at SA interactive) on 5/22/2024?

{
“revisions”: {
“1150”: {
“revenue_consensus_mean”: {
“1”: [
{
“asofdate”: “2024-04-09T00:00:00.000-04:00”,
“numanalysts”: 32,
“numanalystsup”: 32,
“numanalystsnochange”: 0,
“numanalystsdown”: 0,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 1,
“fiscalyear”: 2025,
“calendarquarter”: 1,
“calendaryear”: 2024,
“periodenddate”: “2024-04-30T00:00:00.000-04:00”,
“advancedate”: null
}
}
],
“2”: [
{
“asofdate”: “2024-04-09T00:00:00.000-04:00”,
“numanalysts”: 32,
“numanalystsup”: 32,
“numanalystsnochange”: 0,
“numanalystsdown”: 0,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 2,
“fiscalyear”: 2025,
“calendarquarter”: 2,
“calendaryear”: 2024,
“periodenddate”: “2024-07-31T00:00:00.000-04:00”,
“advancedate”: null
}
}
],
“3”: [
{
“asofdate”: “2024-04-09T00:00:00.000-04:00”,
“numanalysts”: 32,
“numanalystsup”: 32,
“numanalystsnochange”: 0,
“numanalystsdown”: 0,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 3,
“fiscalyear”: 2025,
“calendarquarter”: 3,
“calendaryear”: 2024,
“periodenddate”: “2024-10-31T00:00:00.000-04:00”,
“advancedate”: null
}
}
]
},
“eps_normalized_consensus_mean”: {
“1”: [
{
“asofdate”: “2024-04-09T00:00:00.000-04:00”,
“numanalysts”: 35,
“numanalystsup”: 35,
“numanalystsnochange”: 0,
“numanalystsdown”: 0,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 1,
“fiscalyear”: 2025,
“calendarquarter”: 1,
“calendaryear”: 2024,
“periodenddate”: “2024-04-30T00:00:00.000-04:00”,
“advancedate”: null
}
}
],
“2”: [
{
“asofdate”: “2024-04-09T00:00:00.000-04:00”,
“numanalysts”: 35,
“numanalystsup”: 34,
“numanalystsnochange”: 0,
“numanalystsdown”: 1,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 2,
“fiscalyear”: 2025,
“calendarquarter”: 2,
“calendaryear”: 2024,
“periodenddate”: “2024-07-31T00:00:00.000-04:00”,
“advancedate”: null
}
}
],
“3”: [
{
“asofdate”: “2024-04-09T00:00:00.000-04:00”,
“numanalysts”: 35,
“numanalystsup”: 35,
“numanalystsnochange”: 0,
“numanalystsdown”: 0,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 3,
“fiscalyear”: 2025,
“calendarquarter”: 3,
“calendaryear”: 2024,
“periodenddate”: “2024-10-31T00:00:00.000-04:00”,
“advancedate”: null
}
}
]
}
}
},
“estimates”: {
“1150”: {
“revenue_consensus_mean”: {
“0”: [
{
“effectivedate”: “2024-02-20T11:45:46.000-05:00”,
“dataitemvalue”: “20547242180.0”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 4,
“fiscalyear”: 2024,
“calendarquarter”: 4,
“calendaryear”: 2023,
“periodenddate”: “2024-01-31T00:00:00.000-05:00”,
“advancedate”: “2024-02-21T21:20:00.000-05:00”
}
}
],
“1”: [
{
“effectivedate”: “2024-04-08T15:49:40.000-04:00”,
“dataitemvalue”: “24281672790.0”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 1,
“fiscalyear”: 2025,
“calendarquarter”: 1,
“calendaryear”: 2024,
“periodenddate”: “2024-04-30T00:00:00.000-04:00”,
“advancedate”: null
}
}
],
“2”: [
{
“effectivedate”: “2024-04-08T15:49:40.000-04:00”,
“dataitemvalue”: “26463249240.0”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 2,
“fiscalyear”: 2025,
“calendarquarter”: 2,
“calendaryear”: 2024,
“periodenddate”: “2024-07-31T00:00:00.000-04:00”,
“advancedate”: null
}
}
],
“3”: [
{
“effectivedate”: “2024-04-08T15:49:40.000-04:00”,
“dataitemvalue”: “28776927570.0”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 3,
“fiscalyear”: 2025,
“calendarquarter”: 3,
“calendaryear”: 2024,
“periodenddate”: “2024-10-31T00:00:00.000-04:00”,
“advancedate”: null
}
}
],
"-3": [
{
“effectivedate”: “2023-05-22T10:49:12.000-04:00”,
“dataitemvalue”: “6522528380.0”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 1,
“fiscalyear”: 2024,
“calendarquarter”: 1,
“calendaryear”: 2023,
“periodenddate”: “2023-04-30T00:00:00.000-04:00”,
“advancedate”: “2023-05-24T20:20:00.000-04:00”
}
}
],
"-2": [
{
“effectivedate”: “2023-08-22T11:31:37.000-04:00”,
“dataitemvalue”: “11082973520.0”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 2,
“fiscalyear”: 2024,
“calendarquarter”: 2,
“calendaryear”: 2023,
“periodenddate”: “2023-07-31T00:00:00.000-04:00”,
“advancedate”: “2023-08-23T20:22:00.000-04:00”
}
}
],
"-1": [
{
“effectivedate”: “2023-11-19T22:21:34.000-05:00”,
“dataitemvalue”: “16111661290.0”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 3,
“fiscalyear”: 2024,
“calendarquarter”: 3,
“calendaryear”: 2023,
“periodenddate”: “2023-10-31T00:00:00.000-04:00”,
“advancedate”: “2023-11-21T21:20:00.000-05:00”
}
}
]
},
“revenue_actual”: {
“0”: [
{
“effectivedate”: “2024-02-21T21:20:00.000-05:00”,
“dataitemvalue”: “22103000000.0”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 4,
“fiscalyear”: 2024,
“calendarquarter”: 4,
“calendaryear”: 2023,
“periodenddate”: “2024-01-31T00:00:00.000-05:00”,
“advancedate”: “2024-02-21T21:20:00.000-05:00”
}
}
],
"-3": [
{
“effectivedate”: “2023-05-24T20:20:00.000-04:00”,
“dataitemvalue”: “7192000000.0”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 1,
“fiscalyear”: 2024,
“calendarquarter”: 1,
“calendaryear”: 2023,
“periodenddate”: “2023-04-30T00:00:00.000-04:00”,
“advancedate”: “2023-05-24T20:20:00.000-04:00”
}
}
],
"-2": [
{
“effectivedate”: “2023-08-23T20:21:42.000-04:00”,
“dataitemvalue”: “13507000000.0”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 2,
“fiscalyear”: 2024,
“calendarquarter”: 2,
“calendaryear”: 2023,
“periodenddate”: “2023-07-31T00:00:00.000-04:00”,
“advancedate”: “2023-08-23T20:22:00.000-04:00”
}
}
],
"-1": [
{
“effectivedate”: “2023-11-21T21:22:00.000-05:00”,
“dataitemvalue”: “18120000000.0”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 3,
“fiscalyear”: 2024,
“calendarquarter”: 3,
“calendaryear”: 2023,
“periodenddate”: “2023-10-31T00:00:00.000-04:00”,
“advancedate”: “2023-11-21T21:20:00.000-05:00”
}
}
]
},
“eps_gaap_consensus_mean”: {
“0”: [
{
“effectivedate”: “2024-02-20T11:45:46.000-05:00”,
“dataitemvalue”: “4.2348”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 4,
“fiscalyear”: 2024,
“calendarquarter”: 4,
“calendaryear”: 2023,
“periodenddate”: “2024-01-31T00:00:00.000-05:00”,
“advancedate”: “2024-02-21T21:20:00.000-05:00”
}
}
],
“1”: [
{
“effectivedate”: “2024-03-22T07:49:46.000-04:00”,
“dataitemvalue”: “5.12966”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 1,
“fiscalyear”: 2025,
“calendarquarter”: 1,
“calendaryear”: 2024,
“periodenddate”: “2024-04-30T00:00:00.000-04:00”,
“advancedate”: null
}
}
],
“2”: [
{
“effectivedate”: “2024-03-22T07:49:46.000-04:00”,
“dataitemvalue”: “5.48846”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 2,
“fiscalyear”: 2025,
“calendarquarter”: 2,
“calendaryear”: 2024,
“periodenddate”: “2024-07-31T00:00:00.000-04:00”,
“advancedate”: null
}
}
],
“3”: [
{
“effectivedate”: “2024-03-22T07:49:46.000-04:00”,
“dataitemvalue”: “5.85836”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 3,
“fiscalyear”: 2025,
“calendarquarter”: 3,
“calendaryear”: 2024,
“periodenddate”: “2024-10-31T00:00:00.000-04:00”,
“advancedate”: null
}
}
],
"-3": [
{
“effectivedate”: “2023-05-24T04:20:23.000-04:00”,
“dataitemvalue”: “0.61171”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 1,
“fiscalyear”: 2024,
“calendarquarter”: 1,
“calendaryear”: 2023,
“periodenddate”: “2023-04-30T00:00:00.000-04:00”,
“advancedate”: “2023-05-24T20:20:00.000-04:00”
}
}
],
"-2": [
{
“effectivedate”: “2023-08-05T09:16:18.000-04:00”,
“dataitemvalue”: “1.72536”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 2,
“fiscalyear”: 2024,
“calendarquarter”: 2,
“calendaryear”: 2023,
“periodenddate”: “2023-07-31T00:00:00.000-04:00”,
“advancedate”: “2023-08-23T20:22:00.000-04:00”
}
}
],
"-1": [
{
“effectivedate”: “2023-11-18T15:10:10.000-05:00”,
“dataitemvalue”: “3.01756”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 3,
“fiscalyear”: 2024,
“calendarquarter”: 3,
“calendaryear”: 2023,
“periodenddate”: “2023-10-31T00:00:00.000-04:00”,
“advancedate”: “2023-11-21T21:20:00.000-05:00”
}
}
]
},
“eps_normalized_consensus_mean”: {
“0”: [
{
“effectivedate”: “2024-02-20T11:45:46.000-05:00”,
“dataitemvalue”: “4.63176”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 4,
“fiscalyear”: 2024,
“calendarquarter”: 4,
“calendaryear”: 2023,
“periodenddate”: “2024-01-31T00:00:00.000-05:00”,
“advancedate”: “2024-02-21T21:20:00.000-05:00”
}
}
],
“1”: [
{
“effectivedate”: “2024-04-09T23:13:00.000-04:00”,
“dataitemvalue”: “5.51276”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 1,
“fiscalyear”: 2025,
“calendarquarter”: 1,
“calendaryear”: 2024,
“periodenddate”: “2024-04-30T00:00:00.000-04:00”,
“advancedate”: null
}
}
],
“2”: [
{
“effectivedate”: “2024-04-09T23:13:00.000-04:00”,
“dataitemvalue”: “5.89085”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 2,
“fiscalyear”: 2025,
“calendarquarter”: 2,
“calendaryear”: 2024,
“periodenddate”: “2024-07-31T00:00:00.000-04:00”,
“advancedate”: null
}
}
],
“3”: [
{
“effectivedate”: “2024-04-09T23:13:00.000-04:00”,
“dataitemvalue”: “6.40146”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 3,
“fiscalyear”: 2025,
“calendarquarter”: 3,
“calendaryear”: 2024,
“periodenddate”: “2024-10-31T00:00:00.000-04:00”,
“advancedate”: null
}
}
],
"-3": [
{
“effectivedate”: “2023-05-22T03:10:16.000-04:00”,
“dataitemvalue”: “0.91751”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 1,
“fiscalyear”: 2024,
“calendarquarter”: 1,
“calendaryear”: 2023,
“periodenddate”: “2023-04-30T00:00:00.000-04:00”,
“advancedate”: “2023-05-24T20:20:00.000-04:00”
}
}
],
"-2": [
{
“effectivedate”: “2023-08-22T11:31:37.000-04:00”,
“dataitemvalue”: “2.08726”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 2,
“fiscalyear”: 2024,
“calendarquarter”: 2,
“calendaryear”: 2023,
“periodenddate”: “2023-07-31T00:00:00.000-04:00”,
“advancedate”: “2023-08-23T20:22:00.000-04:00”
}
}
],
"-1": [
{
“effectivedate”: “2023-11-19T22:21:34.000-05:00”,
“dataitemvalue”: “3.38571”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 3,
“fiscalyear”: 2024,
“calendarquarter”: 3,
“calendaryear”: 2023,
“periodenddate”: “2023-10-31T00:00:00.000-04:00”,
“advancedate”: “2023-11-21T21:20:00.000-05:00”
}
}
]
},
“eps_gaap_actual”: {
“0”: [
{
“effectivedate”: “2024-02-21T21:20:00.000-05:00”,
“dataitemvalue”: “4.93”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 4,
“fiscalyear”: 2024,
“calendarquarter”: 4,
“calendaryear”: 2023,
“periodenddate”: “2024-01-31T00:00:00.000-05:00”,
“advancedate”: “2024-02-21T21:20:00.000-05:00”
}
}
],
"-3": [
{
“effectivedate”: “2023-05-24T20:20:00.000-04:00”,
“dataitemvalue”: “0.82”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 1,
“fiscalyear”: 2024,
“calendarquarter”: 1,
“calendaryear”: 2023,
“periodenddate”: “2023-04-30T00:00:00.000-04:00”,
“advancedate”: “2023-05-24T20:20:00.000-04:00”
}
}
],
"-2": [
{
“effectivedate”: “2023-08-23T20:21:42.000-04:00”,
“dataitemvalue”: “2.48”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 2,
“fiscalyear”: 2024,
“calendarquarter”: 2,
“calendaryear”: 2023,
“periodenddate”: “2023-07-31T00:00:00.000-04:00”,
“advancedate”: “2023-08-23T20:22:00.000-04:00”
}
}
],
"-1": [
{
“effectivedate”: “2023-11-21T21:22:00.000-05:00”,
“dataitemvalue”: “3.71”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 3,
“fiscalyear”: 2024,
“calendarquarter”: 3,
“calendaryear”: 2023,
“periodenddate”: “2023-10-31T00:00:00.000-04:00”,
“advancedate”: “2023-11-21T21:20:00.000-05:00”
}
}
]
},
“eps_normalized_actual”: {
“0”: [
{
“effectivedate”: “2024-02-21T21:20:00.000-05:00”,
“dataitemvalue”: “5.16”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 4,
“fiscalyear”: 2024,
“calendarquarter”: 4,
“calendaryear”: 2023,
“periodenddate”: “2024-01-31T00:00:00.000-05:00”,
“advancedate”: “2024-02-21T21:20:00.000-05:00”
}
}
],
"-3": [
{
“effectivedate”: “2023-05-24T20:20:00.000-04:00”,
“dataitemvalue”: “1.09”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 1,
“fiscalyear”: 2024,
“calendarquarter”: 1,
“calendaryear”: 2023,
“periodenddate”: “2023-04-30T00:00:00.000-04:00”,
“advancedate”: “2023-05-24T20:20:00.000-04:00”
}
}
],
"-2": [
{
“effectivedate”: “2023-08-23T20:21:42.000-04:00”,
“dataitemvalue”: “2.7”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 2,
“fiscalyear”: 2024,
“calendarquarter”: 2,
“calendaryear”: 2023,
“periodenddate”: “2023-07-31T00:00:00.000-04:00”,
“advancedate”: “2023-08-23T20:22:00.000-04:00”
}
}
],
"-1": [
{
“effectivedate”: “2023-11-21T21:22:00.000-05:00”,
“dataitemvalue”: “4.02”,
“period”: {
“periodtypeid”: “quarterly”,
“fiscalquarter”: 3,
“fiscalyear”: 2024,
“calendarquarter”: 3,
“calendaryear”: 2023,
“periodenddate”: “2023-10-31T00:00:00.000-04:00”,
“advancedate”: “2023-11-21T21:20:00.000-05:00”
}
}
]
}
}
}
}

Rapid account: Apidojo
apidojo Commented hace 25 días

Did you play with other optional parameters? For example “relative_periods”

Regards.

Join in the discussion - add comment below:

Login / Signup to post new comments