Stock Dividends Data (Investing.com) Actor

Overview

The Stock Dividends Data Actor retrieves comprehensive dividend information for publicly traded stocks from Investing.com. This powerful tool provides both historical dividend data and current dividend metrics, making it perfect for investment research, financial analysis, and portfolio management.

Features

• Comprehensive Dividend Data: Get detailed historical dividend payments with dates, amounts, and yields
• Summary Metrics: Access key dividend metrics including payout ratios, yield percentages, and growth statistics
• Multi-Country Support: Retrieve data for stocks listed in 45+ countries worldwide
• Real-time Data: Fresh data directly from Investing.com
• Structured Output: Clean, JSON-formatted data ready for analysis
• Error Handling: Robust error handling with detailed logging

Input Parameters

Required Parameters

• stockSymbol (string, required)
  • The stock ticker symbol to retrieve dividend information for
  • Example: "AAPL", "MSFT", "KO"
  • Default: "KO"

Optional Parameters

• country (string, optional)
  • The country where the stock is listed
  • Default: "united states"
  • Supported countries include:
    • Americas: United States, Canada, Brazil, Mexico, Argentina, Chile, Colombia, Peru
    • Europe: United Kingdom, Germany, France, Italy, Spain, Netherlands, Belgium, Portugal, Austria, Switzerland, Norway, Sweden, Denmark, Finland, Poland, Czech Republic, Hungary, Greece, Turkey, Russia
    • Asia-Pacific: China, Japan, South Korea, India, Australia, Malaysia, Singapore, Thailand, Indonesia, Philippines, Vietnam, Taiwan, Hong Kong, New Zealand
    • Middle East & Africa: Israel, Saudi Arabia, United Arab Emirates, South Africa

Output Data Structure

The Actor returns a comprehensive dataset with the following structure:

Main Output Fields

• stock: The stock symbol that was queried
• country: The country parameter used in the query
• retrieved_at: ISO timestamp of when the data was retrieved
• total_dividend_records: Total number of historical dividend records found
• summary: Array containing dividend summary metrics
• history: Array of historical dividend payments

Summary Data Fields

The summary object contains key dividend metrics:

• payoutRatio: Percentage of earnings paid out as dividends
• earningsRetained: Percentage of earnings retained by the company
• dividendYield: Current dividend yield information
• annualizedPayout: Annualized dividend payout percentage
• 5-YearsGrowth: Five-year dividend growth rate
• growthStreak: Boolean indicating if there's a current growth streak
• EPS: Earnings per share
• equityIndustryMedian: Industry median comparison value
• equityDividendPaymentType: Payment frequency (e.g., "Quarterly", "Monthly")
• nextDividendData: Information about the next expected dividend payment

Historical Data Fields

Each historical dividend record includes:

• Date: Ex-dividend date (YYYY-MM-DD format)
• Dividend: Dividend amount per share
• Type: Dividend type (e.g., "quarterly", "special")
• Payment Date: Actual payment date
• Yield: Dividend yield at the time of payment

Usage Examples

Basic Usage

{
  "stockSymbol": "AAPL"
}

Specify Country

{
  "stockSymbol": "ASML",
  "country": "netherlands"
}

European Stock Example

{
  "stockSymbol": "SAP",
  "country": "germany"
}

Sample Output

{
  "stock": "AAPL",
  "country": "united states",
  "retrieved_at": "2025-06-30T10:46:40.489968",
  "summary": [
    {
      "payoutRatio": "15.74%",
      "earningsRetained": "84.26%",
      "dividendYield": "Is AAPL's dividend safe?",
      "annualizedPayout": "0.52%",
      "5-YearsGrowth": "+5.37%",
      "growthStreak": false,
      "EPS": "6.43",
      "equityIndustryMedian": 0.5,
      "equityDividendPaymentType": "Quarterly",
      "nextDividendData": null
    }
  ],
  "history": [
    {
      "Date": "2025-05-12",
      "Dividend": 0.26,
      "Type": "quarterly",
      "Payment Date": "2025-05-15",
      "Yield": "0.52%"
    },
    {
      "Date": "2025-02-10",
      "Dividend": 0.25,
      "Type": "quarterly",
      "Payment Date": "2025-02-13",
      "Yield": "0.44%"
    }
  ],
  "total_dividend_records": 20
}

Use Cases

Investment Research

• Analyze dividend history and trends for potential investments
• Compare dividend yields across different stocks and sectors
• Evaluate dividend sustainability using payout ratios

Portfolio Management

• Track dividend income from existing holdings
• Monitor dividend growth patterns
• Plan for dividend reinvestment strategies

Financial Analysis

• Calculate total return including dividends
• Assess dividend safety using earnings coverage
• Compare company dividend policies

Academic Research

• Study dividend policies across different markets
• Analyze dividend trends over time
• Research correlation between dividends and stock performance

Error Handling

The Actor includes comprehensive error handling for common scenarios:

• Invalid Stock Symbol: Returns error if stock symbol is empty or invalid
• Invalid Country: Validates country parameter and provides clear error messages
• Network Issues: Handles connection errors gracefully
• Data Parsing Errors: Manages JSON parsing issues
• No Data Found: Provides clear indication when no dividend data is available

Rate Limits and Best Practices

• The Actor respects Investing.com's rate limits
• For bulk processing, consider adding delays between requests
• Cache results when possible to avoid redundant API calls
• Monitor Actor logs for any rate limiting warnings

Troubleshooting

Common Issues

1. No Data Returned

   • Verify the stock symbol is correct and actively traded
   • Ensure the country parameter matches where the stock is listed
   • Some stocks may not have dividend history

2. Incorrect Country

   • Double-check that the stock is listed in the specified country
   • Some stocks may be listed in multiple countries

3. Rate Limiting

   • If encountering rate limits, reduce request frequency
   • Consider using the Actor's built-in retry mechanisms

Data Freshness

• Data is retrieved in real-time from Investing.com
• Historical data includes all available dividend payments
• Summary metrics reflect the most current available information
• The retrieved_at timestamp indicates when the data was last fetched

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.

---