Stock Earnings (investing.com) - Actor Summary

Overview

This actor scrapes historical earnings data for stocks from Investing.com. It fetches detailed quarterly/annual reports, including actual vs. forecasted figures for EPS and revenue, surprise percentages, and price change metrics. It supports stocks from over 45 countries.

Key Features

• Earnings Data: Retrieves historical records with actual and forecasted EPS, revenue, surprise percentages, and post-announcement price changes.
• Global Coverage: Works with stocks from 45+ countries, including major markets like the US, UK, Germany, Japan, and Canada.
• Structured Output: Returns clean JSON data for easy parsing and integration.
• Summary Statistics: Provides a summary object with counts, averages, and latest report details.

How to Use

Configure the actor run with input parameters. Only the stock symbol is required.

Basic Input

{
  "stockSymbol": "AAPL"
}

Specifying a Country

If the stock is not listed in the United States (the default), specify its country.

{
  "stockSymbol": "BBVA",
  "country": "spain"
}

Input Parameters

Supported Countries: Includes United States, United Kingdom, Germany, France, Japan, China, Canada, Australia, Spain, Italy, Netherlands, Brazil, Mexico, India, South Korea, and many more European, Asian, and South American markets.

Output Data

The main output is an array of earnings record objects in the dataset. Each record contains:

{
  "currencyId": 12,
  "date": "2025-07-23T00:00:00.000Z",
  "epsActual": 0.52,
  "epsForecast": 0.61,
  "epsSurprisePercent": -14.75,
  "priceChangePercent": -14.12,
  "reportMonth": 6,
  "reportYear": 2025,
  "revenueActual": 25500000000,
  "revenueForecast": 24330000000,
  "revenueSurprisePercent": 4.81
}

• currencyId: Internal currency identifier.
• date: Earnings announcement date (ISO).
• epsActual/revenueActual: The reported figures.
• epsForecast/revenueForecast: The analyst consensus forecasts.
• epsSurprisePercent/revenueSurprisePercent: Percentage difference between actual and forecast.
• priceChangePercent: Stock price change following the earnings release.
• reportMonth/reportYear: The fiscal period end.

A summary object is also saved to the key-value store under the OUTPUT key, containing metadata like total_records, latest_earnings_date, latest_eps_actual, and average surprise rates.