Stock Information Data (Investing.com) - Actor Documentation ## Overview The Stock Information Data (Investing.com) Actor is a powerful web scraping tool that fetches comprehensive fundamental stock information from Investing.com. This Actor provides detailed financial data for stocks listed across 44 different countries, making it an essential tool for financial analysis, investment research, and market monitoring. ## Features - Global Coverage: Supports stocks from 44 countries including major markets like US, UK, Germany, Spain, Japan, and more - Comprehensive Data: Retrieves detailed fundamental information including financials, ratios, and market data - Real-time Information: Fetches current stock prices, market cap, trading volume, and other live market data - Extended Market Data: Includes pre-market and after-hours trading information - Structured Output: Returns data in JSON format with metadata for easy integration - Error Handling: Robust error handling with detailed logging and validation ## Input Parameters ### Required Parameters | Parameter | Type | Description | Example | |-----------|------|-------------|---------| | stockSymbol | string | Stock ticker symbol (1-10 characters) | "AAPL", "BBVA", "MSFT" | ### Optional Parameters | Parameter | Type | Description | Default | Options | |-----------|------|-------------|---------|---------| | country | string | Country where the stock is listed | "united states" | See supported countries below | ### Supported Countries The Actor supports stocks from the following 44 countries: - Europe: Spain, United Kingdom, Germany, France, Italy, Netherlands, Belgium, Portugal, Austria, Switzerland, Norway, Sweden, Denmark, Finland, Poland, Czech Republic, Hungary, Greece, Turkey, Russia - Americas: United States, Canada, Brazil, Mexico, Argentina, Chile, Colombia, Peru - 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 JSON object containing: ### Main Response Fields | Field | Type | Description | |-------|------|-------------| | stock | string | Input stock symbol | | country | string | Input country (lowercase) | | as_json | boolean | Data format flag (always true) | | retrieved_at | string | ISO timestamp of data retrieval | | data_format | string | Format type ("json") | | stock_symbol | string | Actual ticker symbol from source | | stock_information | object | Complete stock data (see below) | | has_data | boolean | Indicates if data was successfully retrieved | ### Stock Information Object The stock_information object contains detailed fundamental and market data: #### Company Information - instrumentId: Unique identifier from Investing.com - isin: International Securities Identification Number - companyName: Full company name - tickerSymbol: Stock ticker symbol - exchange: Full exchange name - exchangeSymbol: Exchange abbreviation - employees: Number of employees - description: Detailed company description - industry: Industry classification with link - market: Market information with link - sector: Sector classification with link #### Price & Market Data - lastPrice: Current stock price - change: Price change from previous close - changePercent: Percentage change from previous close - openPrice: Opening price for the day - highPrice: Daily high price - lowPrice: Daily low price - currency: Trading currency - 52WeekHigh: 52-week high price - 52WeekLow: 52-week low price - volume: Trading volume - marketCap: Market capitalization #### Financial Ratios & Metrics - EPS(Earnings Per Share): Earnings per share - P/E_Ratio: Price-to-earnings ratio - dividendYield: Dividend yield percentage - beta: Stock's beta coefficient - 1_Year_Return: One-year return percentage - next_Earnings_Date: Next earnings announcement date #### Extended Trading Data The allPrices object includes additional market data: - Pre-market and after-hours pricing - Extended trading hours information - Detailed price precision settings - Last update timestamps ## Example Usage ### Basic Usage json { "stockSymbol": "AAPL" } ### With Country Specification json { "stockSymbol": "BBVA", "country": "spain" } ### European Stock Example json { "stockSymbol": "SAP", "country": "germany" } ## Example Output json { "stock": "AAPL", "country": "united states", "as_json": true, "retrieved_at": "2025-07-01T11:28:57.663299", "data_format": "json", "stock_symbol": "AAPL", "stock_information": { "instrumentId": "6408", "isin": "US0378331005", "companyName": "Apple Inc", "tickerSymbol": "AAPL", "exchange": "Nasdaq Stock Exchange", "exchangeSymbol": "NASDAQ", "employees": 164000, "description": "Apple Inc. designs, manufactures, and markets smartphones...", "industry": { "name": "Computers, Phones & Household Electronics", "link": "/stock-screener/united-states/technology/computers-phones-and-household-electronics" }, "market": { "name": "United States", "link": "/markets/united-states" }, "sector": { "name": "Technology", "link": "/stock-screener/united-states/technology" }, "lastPrice": 205.17, "change": 4.09, "changePercent": 2.03, "openPrice": 202.01, "highPrice": 207.39, "lowPrice": 199.26, "currency": "USD", "52WeekHigh": 260.1, "52WeekLow": 169.21, "volume": null, "marketCap": "3.06T", "EPS(Earnings Per Share)": 6.43, "P/E_Ratio": 31.82, "dividendYield": 0.51, "beta": 1.27, "1_Year_Return": -2.59, "next_Earnings_Date": "2025-07-23 00:00:00", "allPrices": { "instrumentId": "6408", "open": 202.01, "lastClose": 205.17, "currency": "USD", "isDelayed": false, "lastUpdateTime": "1751313599000", "fiftyTwoWeekHigh": 260.1, "fiftyTwoWeekLow": 169.21, "last": 205.17, "changePcr": 2.03, "change": 4.09, "premarketPrice": 205.55, "premarketChange": 0.38, "premarketChangePercent": 0.19, "afterHoursPrice": 205.55, "afterHoursChange": 0.38, "afterHoursChangePercent": 0.19, "showExtendedHours": "PreMarket", "high": 207.39, "low": 199.26 } }, "has_data": true } ## Error Handling The Actor includes comprehensive error handling for various scenarios: ### Input Validation Errors - Empty Stock Symbol: Returns validation error if stock symbol is empty or invalid - Invalid Country: Returns validation error if country parameter is invalid - Parameter Type Errors: Validates that parameters are of correct data types ### Runtime Errors - Connection Errors: Handles network connectivity issues - IO Errors: Manages file system and data access problems - Runtime Errors: Catches unexpected runtime exceptions - Data Not Found: Gracefully handles cases where stock data is unavailable ### Error Response Format When errors occur, the Actor returns structured error information: json { "stock": "INVALID", "country": "united states", "has_data": false, "error": "Validation error: stock must be a non-empty string", "retrieved_at": "2025-07-01T11:28:57.663299" } ## Use Cases ### Financial Analysis - Portfolio management and tracking - Investment research and due diligence - Risk assessment using beta and volatility metrics - Comparative analysis across markets ### Market Monitoring - Real-time price tracking - Market capitalization monitoring - Volume analysis - Pre-market and after-hours activity tracking ### Data Integration - Feeding financial dashboards - Integration with trading systems - Data warehouse population - API backend for financial applications ### Research & Reporting - Fundamental analysis reports - Market research studies - Academic financial research - Investment newsletter automation ## Performance & Limits ### Rate Limiting - The Actor respects Investing.com's rate limits - Recommended to add delays between requests for bulk operations - Monitor your usage to avoid being blocked ### Data Freshness - Real-time data during market hours - Pre-market and after-hours data when available - Historical reference points (52-week high/low, etc.) ### Reliability - Built-in retry mechanisms for transient failures - Comprehensive logging for troubleshooting - Graceful degradation when partial data is available ## Best Practices ### Input Optimization 1. Use Correct Symbols: Ensure stock symbols match those used on Investing.com 2. Country Matching: Select the correct country for the stock's primary listing 3. Symbol Validation: Verify symbols exist before bulk processing ### Error Handling 1. Check has_data Field: Always verify data availability before processing 2. Handle Partial Data: Some fields may be null or unavailable 3. Implement Retries: Add retry logic for transient failures ### Data Processing 1. Timestamp Tracking: Use retrieved_at for data freshness validation 2. Currency Awareness: Consider currency when comparing prices across markets 3. Market Hours: Account for different market hours across countries ## Integration Examples ### Python Integration python import requests # Run the Actor response = requests.post( 'https://api.apify.com/v2/acts/the-actor-id/runs', headers={'Authorization': 'Bearer YOUR_API_TOKEN'}, json={ 'stockSymbol': 'AAPL', 'country': 'united states' } ) # Process results if response.status_code == 200: run_data = response.json() # Handle the stock data ### JavaScript Integration javascript const axios = require('axios'); async function getStockData(symbol, country = 'united states') { try { const response = await axios.post( 'https://api.apify.com/v2/acts/the-actor-id/runs', { stockSymbol: symbol, country: country }, { headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' } } ); return response.data; } catch (error) { console.error('Error fetching stock data:', error); throw error; } } ## Support & Troubleshooting ### Common Issues 1. Stock Not Found: Verify the stock symbol exists on Investing.com for the specified country 2. Empty Results: Check if the market is open or if the stock is actively traded 3. Rate Limiting: Reduce request frequency if encountering blocks ### Debugging - Check Actor logs for detailed error information - Verify input parameters match expected formats - Test with known working stock symbols first ### Data Quality - Cross-reference critical data points with other sources - Monitor for unusual values that might indicate data issues - Report persistent data quality problems ## 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. ---