Stock Financials Summary Data (Investing.com) - Apify Actor

Overview

The Stock Financials Summary Data (Investing.com) Actor is a powerful tool that fetches comprehensive financial summary data for publicly traded companies from various global stock exchanges. This Actor retrieves key financial statements including income statements, balance sheets, and cash flow statements for any specified stock symbol and country.

Key Features

• Multi-Market Support: Access financial data from 45+ countries including major markets like US, UK, Germany, Japan, China, and more
• Comprehensive Financial Data: Retrieve income statements, balance sheets, and cash flow statements
• Flexible Time Periods: Get annual, quarterly, or interim financial data
• Structured Output: Clean, well-organized JSON data with metadata and date ranges
• Error Handling: Robust validation and error reporting for reliable data extraction
• Historical Data: Access multiple years of financial data with clear date ranges

Input Configuration

Required Parameters

Parameter	Type	Description	Default	Example
stockSymbol	String	Stock ticker symbol (1-10 characters)	"AAPL"	"AAPL", "MSFT", "GOOGL"
country	String	Country where the stock is listed	"united states"	"united states", "germany", "japan"
summaryType	String	Type of financial statement	"income_statement"	"income_statement", "balance_sheet", "cash_flow_statement"
period	String	Time period for data	"annual"	"annual", "quarterly", "Interim"

Supported Countries

The Actor supports financial data extraction from 45+ countries:

Major Markets: United States, United Kingdom, Germany, France, Italy, Spain, Netherlands, Switzerland, Japan, China, South Korea, India, Australia, Canada, Brazil

European Markets: Belgium, Portugal, Austria, Norway, Sweden, Denmark, Finland, Poland, Czech Republic, Hungary, Greece, Turkey, Russia

Asian Markets: Malaysia, Singapore, Thailand, Indonesia, Philippines, Vietnam, Taiwan, Hong Kong

Other Markets: Mexico, Argentina, Chile, Colombia, Peru, South Africa, Israel, Saudi Arabia, United Arab Emirates, New Zealand

Financial Statement Types

1. Income Statement (income_statement)

   • Revenue and earnings data
   • Operating income and expenses
   • Net income and profitability metrics

2. Balance Sheet (balance_sheet)

   • Assets, liabilities, and equity
   • Working capital information
   • Financial position snapshots

3. Cash Flow Statement (cash_flow_statement)

   • Operating cash flows
   • Investment and financing activities
   • Free cash flow metrics

Period Options

• Annual: Full year financial data
• Quarterly: Quarterly financial reports
• Interim: Mid-year or interim reporting periods

Input Example

{
  "stockSymbol": "AAPL",
  "country": "united states",
  "summaryType": "income_statement",
  "period": "annual"
}

Output Format

The Actor returns structured JSON data with the following format:

Main Output Structure

{
  "stock": "AAPL",
  "country": "united states",
  "summary_type": "income_statement",
  "period": "annual",
  "retrieved_at": "2025-06-30T12:03:22.418913",
  "financial_data": {
    "2024-09-28T00:00:00": {
      "Total Revenue": 391035.0,
      "Gross Profit": 180683.0,
      "Operating Income": 123216.0,
      "Net Income": 93736.0
    },
    "2023-09-30T00:00:00": {
      "Total Revenue": 383285.0,
      "Gross Profit": 169148.0,
      "Operating Income": 114301.0,
      "Net Income": 96995.0
    }
  },
  "total_periods": 4,
  "columns": [
    "Total Revenue",
    "Gross Profit",
    "Operating Income",
    "Net Income"
  ],
  "date_range": {
    "start": "2021-09-30T00:00:00",
    "end": "2024-09-28T00:00:00"
  }
}

Output Fields Description

Field	Type	Description
stock	String	The stock symbol that was queried
country	String	The country market that was queried
summary_type	String	The type of financial statement retrieved
period	String	The period type (annual/quarterly/interim)
retrieved_at	String	ISO timestamp of when data was retrieved
financial_data	Object	Financial data organized by date periods
total_periods	Number	Total number of periods returned
columns	Array	List of financial metrics included
date_range	Object	Start and end dates of the data range

Use Cases

1. Financial Analysis

• Compare year-over-year performance
• Analyze revenue trends and growth rates
• Evaluate profitability metrics across periods

2. Investment Research

• Screen stocks based on financial criteria
• Build financial models and valuations
• Track quarterly earnings progression

3. Market Research

• Compare companies within same industry
• Analyze market trends across different countries
• Build comprehensive financial databases

4. Automated Reporting

• Generate regular financial reports
• Monitor portfolio companies' performance
• Create alerts based on financial thresholds

Error Handling

The Actor includes comprehensive error handling for common scenarios:

• Invalid Stock Symbols: Validates ticker format and length
• Unsupported Countries: Ensures country is in supported list
• Network Issues: Handles connection errors gracefully
• Data Unavailability: Reports when no data is found for the specified parameters
• Validation Errors: Clear error messages for invalid inputs

Performance and Limits

• Speed: Typically processes requests in 10-30 seconds
• Rate Limits: Respects source website rate limits
• Data Freshness: Retrieves latest available financial data
• Historical Coverage: Usually provides 3-5 years of historical data

Best Practices

1. Input Validation

{
  "stockSymbol": "AAPL",          // Use official ticker symbols
  "country": "united states",     // Use lowercase country names
  "summaryType": "income_statement",
  "period": "annual"
}

2. Error Handling

Always check the total_periods field to ensure data was retrieved:

if (result.total_periods > 0) {
  // Process financial data
} else {
  // Handle no data scenario
}

3. Data Processing

Financial data is organized by date, with the most recent period first.

Common Issues and Solutions

Issue: No Data Retrieved

Cause: Stock symbol not found or not available in specified country Solution: Verify ticker symbol and try different country markets

Issue: Validation Error

Cause: Invalid input parameters Solution: Check parameter format and ensure required fields are provided

Issue: Connection Timeout

Cause: Network issues or source website unavailability Solution: Retry the request after a few minutes

Integration Examples

JavaScript/Node.js

const ApifyClient = require('apify-client');
const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const input = {
  stockSymbol: 'AAPL',
  country: 'united states',
  summaryType: 'income_statement',
  period: 'annual'
};

const run = await client.actor('your-actor-id').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run_input = {
    "stockSymbol": "AAPL",
    "country": "united states",
    "summaryType": "income_statement",
    "period": "annual"
}

run = client.actor("the-actor-id").call(run_input=run_input)
items = client.dataset(run["defaultDatasetId"]).list_items().items
print(items[0])

Support

If you have any questions or encounter any issues, please consult the Apify documentation or reach out to us through one of the following channels:

• Telegram: @pintoflow
• Apify Platform: You can also contact us directly through this platform.

---