📊 Stock Insights Data (Investing.com) - Apify Actor Fetch detailed fair value insights and key financial indicators for global stocks from Investing.com using this Apify Actor. --- ## 🧠 What It Does This Actor scrapes stock fair value data and financial insights (a.k.a. "finsights") from Investing.com, including sentiment analysis and relevance-weighted metrics. It’s useful for: - Financial research - Building investment dashboards - Detecting undervalued or overvalued stocks - Tracking buybacks, dividends, and valuation metrics --- ## 📥 Input Schema | Field | Type | Required | Description | |--------------|----------|----------|-----------------------------------------------------------------------------| | stockSymbol| string | ✅ Yes | The stock ticker symbol (e.g. AAPL, MSFT, BBVA) | | country | string | ❌ No | Country where the stock is listed (default: united states) | ### Supported Countries - United States - United Kingdom - Spain - Germany - France - Italy - Netherlands - Belgium - Portugal - Austria - Switzerland - Sweden - Norway - 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 --- ## 📤 Output Example The Actor returns a JSON object containing: - company_name: Full name of the company - finsights: Array of financial insights (metrics + sentiment) - metric: Contains: - slug: Metric name - value: Metric numeric value - currency: If applicable (e.g., USD) - scale: Scaling factor (e.g., 1, 1,000,000) - percentile: Ranking percentile vs. peers - sentiment: One of WIN, WARN, or WOE - relevance: Importance score (0–100) - brief: Summary description - locked: Whether the data is fully accessible or restricted ### Example Output json { "company_name": "Apple Inc.", "finsights": [ { "tags": ["value"], "brief": "Management has been aggressively buying back shares", "sentiment": "WIN", "relevance": 92.5, "metric": { "slug": "buyback_yield", "value": 0.034, "currency": "", "scale": 1, "percentile": 0.86 }, "locked": false }, { "tags": ["dividend"], "brief": "Has raised its dividend for 13 consecutive years", "sentiment": "WIN", "relevance": 75, "metric": { "slug": "div_growth_streak", "value": 13, "currency": "", "scale": 1, "percentile": 1 }, "locked": false } // ...more finsights ] } ```` > 🔐 Some insights may be `locked` depending on availability or Investing.com restrictions. --- ## 🛠️ How It Works 1. Receives `stockSymbol` and `country` as input. 2. Validates inputs and logs activity. 3. make the calls to retrieve the data. 4. Pushes detailed insight records to the dataset. 5. Stores a summary in a key-value store (`insights_summary`) with: * `stock`, `country`, `retrieved_at`, etc. * Metadata like `top_finsight`, `company_name`, and `has_data` --- ## 📦 Dataset & Storage * All results are pushed to the Actor's **default dataset**. * A summary object is stored in the Actor's **Key-value store** as `insights_summary`. --- ## ❌ Error Handling If the Actor fails due to bad inputs or request errors, it will: * Log a detailed error to Apify logs * Call `Actor.fail()` to stop gracefully * Return an object with `has_data: false` and `error` message --- ## ▶️ Example Run Input:json { "stockSymbol": "AAPL", "country": "united states" } Output Summary (`insights_summary`):json { "stock": "AAPL", "country": "united states", "stock_symbol": "AAPL", "company_name": "Apple Inc.", "has_data": true, "finsights_count": 13, "top_finsight": { "brief": "Management has been aggressively buying back shares", "relevance": 92.5 }, "retrieved_at": "2025-07-03T14:10:00Z" } ``` --- ## 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: - Verify input parameters match the schema requirements - Check the Apify platform documentation - Review the actor logs for detailed error messages * Telegram: @pintoflow * Apify Platform: You can also contact us directly through this platform. ---