Pricing

Rating

Developer

Actor stats

Categories

Share

📈 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

🧪 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.