Example

Google Sheets / Apps Script Calendar Sync

Let analysts work from a spreadsheet instead of an app.

Request

GET https://api.earningsapi.com/v1/calendar/earnings?date=today&apikey=YOUR_API_KEY

Code example

ExamplePython
import datetime as dt
import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.earningsapi.com"

def fetch_calendar(day):
    response = requests.get(
        f"{BASE_URL}/v1/calendar/earnings",
        params={"date": day.isoformat(), "apikey": API_KEY},
        timeout=30,
    )
    response.raise_for_status()
    return response.json()

start = dt.date.today() - dt.timedelta(days=90)
for offset in range(121):
    day = start + dt.timedelta(days=offset)
    calendar = fetch_calendar(day)
    print(day, len(calendar.get("pre", [])), len(calendar.get("after", [])))

Result shape

datesymbolnamebucket
2026-01-31AAPLApple Inc.after
2026-02-01MSFTMicrosoft Corporationafter

Build steps

  1. 1Store the API key in Apps Script properties.
  2. 2Loop the next 30 dates and call the calendar endpoint.
  3. 3Flatten reporting buckets into rows before writing to the sheet.

Quota and limits

Compare plan limits and historical data access.

Free

  • 60 requests / minute
  • 100 requests / day
  • 1,000 requests / month
  • The most recent 24 months of historical data on supported endpoints

Pro

  • 300 requests / minute
  • Unlimited daily requests
  • Unlimited monthly requests
  • All available history on supported endpoints

Free daily and monthly quotas reset in New York time. Historical access applies to endpoints marked Historical access.

View usage and plans