📈 Stock Asset Metrics Data (Investing.com) — Apify Actor

This Apify Actor retrieves fundamental financial metrics for a given stock symbol from Investing.com. It is particularly useful for extracting key valuation indicators, profitability ratios, and stock health indicators based on country and symbol.

---

🧠 What It Does

The Actor accepts a stock symbol and the listing country, and returns structured asset metrics such as:

• Fair Value
• Net Income
• EPS Growth Forecast
• Dividend Payment and Growth Streaks
• Book Value per Share
• Return on Assets & Equity
• Gross Profit Margin
• Price-to-Book Ratio
• EBITDA & EV/EBITDA
• RSI (Relative Strength Index)

It stores this information in the Apify dataset and provides a summarized version via the key-value store.

---

✅ Example Input

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

---

📤 Example Output

{
  "stock": "AAPL",
  "country": "united states",
  "as_json": true,
  "retrieved_at": "2025-07-02T09:27:07.345642",
  "data_format": "asset_metrics",
  "stock_symbol": "AAPL",
  "asset_metrics": {
    "proFairValue": 178.7715,
    "proNetIncome": 97294,
    "proEpsGrowthForcast": 0.18738257085240625,
    "proDivPaymentStreak": 14,
    "proDivGrowthStreak": 13,
    "proBookValueShare": 4.446523459179036,
    "proReturnOnAssets": 0.29101883812611795,
    "proReturnOnEquity": 1.380154620895099,
    "proGrossProfitMargin": 0.46631999999999996,
    "proPriceBook": 45.87675041050362,
    "proEbitda": 138866,
    "proEvEbitda": 21.817056877997494,
    "RSI(14)": 53.09422089786422
  },
  "has_data": true
}

---

🧩 Output Format

• Dataset Records:

  • Full enriched stock data under asset_metrics
  • Metadata: retrieved_at, stock, country, has_data, data_format

• Key-value Store (asset_metrics_summary):

  • Summary version for quick reference

---

🚨 Error Handling

The Actor includes validation and specific exception messages for:

• Missing or invalid stockSymbol
• Missing country
• Invalid boolean values for as_json
• General API or network errors
• Internal runtime exceptions

Errors are logged and surfaced via Actor.fail.

---

🔄 Internal Logic Overview

1. Accepts stockSymbol and country as input.
2. Validates input types and formats.
3. Calls get_stock_asset_metrics() (custom helper) to fetch metrics from Investing.com.
4. Saves enriched data into the dataset and summary into key-value store.
5. Logs all main steps for traceability.

---

📂 Data Storage

Storage Type	Key/Name	Description
Dataset	default	Raw & enriched asset metrics per stock
Key-Value Store	asset_metrics_summary	Summary of latest stock metrics

---

🧪 Use Cases

• Stock screening tools
• Automated financial report builders
• Quantitative and value-based stock research
• Portfolio analysis engines

---

🚀 Deployment Notes

• Developed using the Apify SDK for Python
• Supports asynchronous execution with full logging
• Designed to be efficient and API-safe

---

🛠️ Requirements

• All countries must be passed in lowercase (e.g., "united states").

---

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.

---