📊 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

{
  "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:

{
  "stockSymbol": "AAPL",
  "country": "united states"
}

Output Summary (insights_summary):

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

---