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 json { "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 json { "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. ---