Stock Profile Data (Investing.com) - Actor Documentation

Overview

The Stock Profile Data (Investing.com) Actor is a powerful web scraping tool that retrieves comprehensive company profile information for publicly traded stocks from Investing.com. This Actor provides detailed company descriptions, executive information, contact details, and additional corporate data for stocks listed across multiple global markets.

Key Features

• Global Stock Coverage: Supports stocks from 44+ countries including major markets like US, UK, Germany, Japan, China, and more
• Multi-language Support: Retrieve data in 24 different languages
• Comprehensive Data: Extract company descriptions, executive teams, contact information, and industry details
• Structured Output: Returns well-formatted JSON data ready for analysis or integration
• Error Handling: Robust validation and error reporting for reliable data extraction

Input Configuration

Required Parameters

• stockSymbol (string, required): The stock ticker symbol to retrieve company profile information for
  • Example: "TSLA", "AAPL", "BBVA"
  • Must be a valid, non-empty string

Optional Parameters

• country (string, optional): The country where the stock is listed

  • Default: "united states"
  • Supported countries include: Spain, United States, United Kingdom, Germany, France, Italy, Netherlands, Belgium, Portugal, Austria, Switzerland, Norway, Sweden, Denmark, Finland, Poland, Czech Republic, Hungary, Greece, Turkey, Russia, China, Japan, South Korea, India, Australia, Canada, Brazil, Mexico, Argentina, Chile, Colombia, Peru, South Africa, Israel, Saudi Arabia, United Arab Emirates, Malaysia, Singapore, Thailand, Indonesia, Philippines, Vietnam, Taiwan, Hong Kong, New Zealand

• language (string, optional): The language for retrieving company profile information

  • Default: "en" (English)
  • Supported languages: English, Spanish, German, French, Italian, Portuguese, Dutch, Russian, Chinese, Japanese, Korean, Arabic, Hindi, Thai, Turkish, Polish, Czech, Hungarian, Greek, Hebrew, Swedish, Norwegian, Danish, Finnish

Input Schema Example

{
  "stockSymbol": "TSLA",
  "country": "united states",
  "language": "en"
}

Output Data Structure

The Actor returns a comprehensive JSON object containing the following information:

Core Information

• stock: The requested stock symbol
• country: The specified country
• language: The specified language
• retrieved_at: ISO timestamp of when the data was retrieved

Company Profile Data

• url: Direct link to the company profile on Investing.com
• description: Detailed company description including business operations, segments, and history
• additionalInfo: Object containing:
  • industry: Company's industry classification
  • sector: Business sector
  • employeesNumber: Number of employees
  • equityType: Type of equity (e.g., "ORD" for ordinary shares)

Contact Information

• address: Company's headquarters address
• phoneNumber: Main contact phone number
• fax: Fax number (if available)
• website: Company's official website URL

Executive Team

• topExecutives: Array of executive information including:
  • name: Executive's full name
  • age: Executive's age
  • since: Year they joined the company/position
  • title: Official title/position

Sample Output

{
  "stock": "TSLA",
  "country": "united states",
  "language": "en",
  "retrieved_at": "2025-06-26T12:48:03.937881",
  "url": "https://investing.com/equities/tesla-motors-company-profile",
  "description": "Tesla, Inc. designs, develops, manufactures, leases, and sells electric vehicles, and energy generation and storage systems in the United States, China, and internationally. The company operates in two segments, Automotive; and Energy Generation and Storage...",
  "additionalInfo": {
    "industry": "Automobiles & Auto Parts",
    "sector": "Consumer Cyclicals",
    "employeesNumber": "140473",
    "equityType": "ORD"
  },
  "address": "1 Tesla Road  Austin ,  78725 United States",
  "phoneNumber": "512 516 8177",
  "fax": "-",
  "website": "www.tesla.com",
  "topExecutives": [
    {
      "name": "Robyn M. Denholm",
      "age": "60",
      "since": "2014",
      "title": "Independent Chairwoman"
    },
    {
      "name": "Elon R. Musk",
      "age": "52",
      "since": "2004",
      "title": "Co-Founder, Technoking of Tesla, CEO & Director"
    }
  ]
}

Use Cases

Financial Analysis

• Research company fundamentals and business operations
• Analyze executive leadership and corporate governance
• Compare companies across different markets and sectors

Investment Research

• Due diligence for investment decisions
• Portfolio company analysis
• Market research and competitive intelligence

Business Intelligence

• Corporate contact information gathering
• Industry analysis and benchmarking
• Executive team research for business development

Data Integration

• Feeding company data into CRM systems
• Populating financial databases
• Supporting automated research workflows

Error Handling

The Actor includes comprehensive error handling for common issues:

• Validation Errors: Invalid or missing stock symbols
• Connection Errors: Network connectivity issues
• Data Retrieval Errors: When company profile data is not available
• Runtime Errors: Unexpected errors during execution

All errors are logged with detailed messages and the Actor will fail gracefully with informative error descriptions.

Best Practices

Input Validation

• Ensure stock symbols are valid and properly formatted
• Use correct country names as specified in the supported list
• Verify language codes match the supported options

Rate Limiting

• Be mindful of request frequency to avoid being blocked
• Consider implementing delays between requests for bulk operations
• Monitor Actor performance and adjust accordingly

Data Quality

• Verify the accuracy of retrieved data, especially for less common stocks
• Cross-reference with other data sources when necessary
• Be aware that data availability may vary by market and stock

Technical Implementation

The Actor is built using:

• Apify SDK: For Actor framework and data handling
• Python: Core implementation language with async/await support
• Robust Error Handling: Comprehensive exception management
• Data Validation: Input parameter validation and sanitization
• Logging: Detailed logging for monitoring and debugging

Limitations

• Data availability depends on Investing.com's coverage of specific stocks
• Some markets or stocks may have limited profile information
• Language availability may vary by market and stock
• Rate limiting may apply based on usage patterns

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.

---