Example

Profile Enrichment Join

Filter earnings results by company metadata.

Request

GET https://api.earningsapi.com/v1/profile/AAPL?apikey=YOUR_API_KEY

Code example

ExamplePython
import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.earningsapi.com"
WATCHLIST = ["AAPL", "MSFT", "NVDA"]

def get_json(path):
    response = requests.get(f"{BASE_URL}{path}", params={"apikey": API_KEY}, timeout=30)
    response.raise_for_status()
    return response.json()

for symbol in WATCHLIST:
    data = get_json("/v1/profile/{symbol}".replace("{symbol}", symbol) + ("?symbol=" + symbol if "{symbol}" not in "/v1/profile/{symbol}" else ""))
    print(symbol, data[:1] if isinstance(data, list) else data)

Result shape

symbolsectorindustrymarketCap
AAPLTechnologyComputer Manufacturing$3.7T
JPMFinancial ServicesBanks$650B

Build steps

  1. 1Fetch the earnings calendar for the target date.
  2. 2Collect unique symbols from pre, after, and notSupplied.
  3. 3Fetch profiles and join metadata back onto each calendar row.

Quota and limits

Free tier includes 60 requests per minute, 100 requests per day, and 1,000 requests per month. Paid plans are built for production use with higher limits and a 300 requests per minute rate limit. Daily and monthly reset windows use New York time.

View usage