Stock Fair Value Data (Investing.com) - Actor Documentation

Overview

The Stock Fair Value Data Actor is a powerful tool that retrieves comprehensive fair value analysis and fundamental financial information for stocks from Investing.com. This actor provides detailed valuation models, analyst targets, market data, and upside/downside potential for any publicly traded stock across multiple global markets.

Features

• Fair Value Analysis: Get detailed fair value calculations using multiple valuation models
• Analyst Targets: Access analyst price targets with statistical ranges and target counts
• Market Data: Current market prices with 52-week highs and lows
• Upside/Downside Analysis: Percentage upside or downside based on fair value vs current price
• Multiple Valuation Models: DCF models, multiple-based valuations, dividend models, and more
• Global Coverage: Support for stocks from 47+ countries worldwide
• Real-time Data: Fresh data with cache expiration timestamps

Input Parameters

Required Parameters

• stockSymbol (string, required)
  • The stock ticker symbol to analyze
  • Examples: "AAPL", "MSFT", "GOOGL", "TSLA"
  • Min length: 1 character
  • Max length: 10 characters

Optional Parameters

• country (string, optional)
  • The country where the stock is listed
  • Default: "united states"
  • Supported countries include:
    • Americas: United States, Canada, Brazil, Mexico, Argentina, Chile, Colombia, Peru
    • Europe: Spain, United Kingdom, Germany, France, Italy, Netherlands, Belgium, Portugal, Austria, Switzerland, Norway, Sweden, Denmark, Finland, Poland, Czech Republic, Hungary, Greece, Turkey, Russia
    • 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

Example Input

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

Output Data Structure

The actor returns a comprehensive JSON object containing:

Main Fields

• stock: The stock symbol (uppercase)
• country: The country where the stock is listed
• retrieved_at: Timestamp when the data was retrieved
• data_format: Always "fair_value"
• stock_symbol: The stock symbol (duplicate for consistency)
• has_data: Boolean indicating if data was successfully retrieved
• fair_value: The main fair value analysis object (detailed below)

Fair Value Object Structure

The fair_value object contains the following comprehensive data:

Summary Metrics

• upside: Percentage upside/downside (-1.1111 means -1.11% downside)
• uncertainty: Uncertainty level (e.g., "UNKNOWN_UNCERTAINTY")
• label: Fair value label (e.g., "FAIR", "OVERVALUED", "UNDERVALUED")
• currency: Currency of the stock price (e.g., "USD")
• locked: Boolean indicating if data is locked/premium

Price Analysis

• price: Fair value price statistics
  • low: Lowest fair value estimate
  • high: Highest fair value estimate
  • median: Median fair value
  • mean: Mean fair value (primary fair value estimate)

Market Data

• market_data: Current market information
  • low: 52-week low
  • high: 52-week high
  • latest: Current market price

Analyst Targets

• analyst_target: Professional analyst price targets
  • values_range: Statistical range of analyst targets
    • low: Lowest analyst target
    • high: Highest analyst target
    • median: Median analyst target
    • mean: Average analyst target
  • targets_count: Number of analyst targets included

Valuation Models

• fair_value_models_aggregate: Aggregated model results

  • name: Model group name
  • low: Lowest model estimate
  • high: Highest model estimate
  • mean: Average of all models

• fair_value_models: Array of individual valuation models

  • Each model includes:
    • name: Model name (e.g., "_invpro_5y_dcf_revenue_exit")
    • price: Fair value price from this model
    • upside: Upside/downside percentage
    • metrics: Model-specific metrics
    • highlights: Key highlights from the model
    • benchmarks: Benchmark comparisons

Metadata

• pair_id: Internal identifier for the stock
• meta: Additional metadata
  • CacheExpiration: When the cached data expires

Available Valuation Models

The actor provides analysis from multiple sophisticated valuation models:

DCF (Discounted Cash Flow) Models

• 5-Year DCF with Revenue Exit: 5-year projection with revenue-based terminal value
• 5-Year DCF with Terminal Growth Exit: 5-year projection with terminal growth rate
• 10-Year DCF with EBITDA Exit: 10-year projection with EBITDA-based terminal value
• 5-Year DCF with EBITDA Exit: 5-year projection with EBITDA-based terminal value
• 10-Year DCF with Terminal Growth Exit: 10-year projection with terminal growth rate
• 10-Year DCF with Revenue Exit: 10-year projection with revenue-based terminal value

Multiple-Based Valuations

• P/E Multiples: Price-to-earnings ratio analysis
• Revenue Multiples: Price-to-sales ratio analysis
• EBITDA Multiples: Enterprise value to EBITDA analysis
• EBIT Multiples: Enterprise value to EBIT analysis
• Price-to-Book Multiples: Price-to-book value analysis
• Price-to-Sales Multiples: Price-to-sales analysis

Dividend Models

• Dividend Stable Growth: Dividend discount model with stable growth
• Dividend Multi-Stage: Multi-stage dividend discount model

Example Output

{
  "stock": "AAPL",
  "country": "united states",
  "retrieved_at": "2025-07-03T09:57:17.984502",
  "data_format": "fair_value",
  "stock_symbol": "AAPL",
  "fair_value": {
    "upside": -1.1111,
    "uncertainty": "UNKNOWN_UNCERTAINTY",
    "label": "FAIR",
    "currency": "USD",
    "price": {
      "low": 0,
      "high": 0,
      "median": 0,
      "mean": 111.11
    },
    "market_data": {
      "low": 169.21,
      "high": 260.1,
      "latest": 212.44
    },
    "analyst_target": {
      "values_range": {
        "low": 173,
        "high": 300,
        "median": 230,
        "mean": 229.04575
      },
      "targets_count": 40
    },
    "fair_value_models_aggregate": {
      "name": "_invpro_models",
      "low": 82.06618,
      "high": 128.99988,
      "mean": 111.111115
    },
    "locked": true,
    "pair_id": "6408",
    "meta": {
      "CacheExpiration": "2025-07-03T09:02:49Z"
    }
  },
  "has_data": true
}

Use Cases

Investment Analysis

• Portfolio Valuation: Analyze fair value of current holdings
• Stock Screening: Identify undervalued or overvalued stocks
• Investment Research: Compare analyst targets with model-based valuations
• Risk Assessment: Evaluate upside/downside potential

Financial Services

• Wealth Management: Provide clients with comprehensive valuation analysis
• Research Reports: Generate detailed fair value assessments
• Trading Strategies: Identify trading opportunities based on fair value gaps
• Due Diligence: Comprehensive stock analysis for investment decisions

Academic & Research

• Financial Modeling: Compare different valuation methodologies
• Market Analysis: Study valuation trends across markets
• Educational Tools: Teach valuation concepts with real data
• Research Papers: Access comprehensive financial data for analysis

Error Handling

The actor includes comprehensive error handling for:

• Validation Errors: Invalid stock symbols or parameters
• Network Issues: Connection problems with data sources
• Data Availability: Stocks with no available fair value data
• Rate Limiting: Automatic retry mechanisms for API limits

When no data is available, the actor returns:

{
  "stock": "SYMBOL",
  "country": "country",
  "retrieved_at": "timestamp",
  "data_format": "fair_value",
  "stock_symbol": "SYMBOL",
  "fair_value": null,
  "has_data": false,
  "error": "No Fair Value data retrieved"
}

Rate Limits & Performance

• Data Freshness: Results are cached with expiration timestamps
• Response Time: Typically 2-5 seconds per request
• Concurrent Requests: Supports multiple parallel requests
• Data Quality: Professional-grade financial data from Investing.com

Best Practices

Input Validation

• Use correct stock symbols for the specified country
• Ensure the stock is publicly traded and available on Investing.com
• Check country spelling matches the supported list

Data Interpretation

• Consider the uncertainty field when making decisions
• Compare multiple valuation models for comprehensive analysis
• Use analyst_target data alongside model-based valuations
• Check cache_expiration for data freshness

Integration Tips

• Store results in your database for historical analysis
• Set up regular runs to track valuation changes over time
• Combine with other financial data sources for comprehensive analysis
• Use the pair_id for tracking specific stocks across runs

Troubleshooting

Common Issues

1. "No Fair Value data retrieved"

   • Stock symbol may be incorrect
   • Stock may not be available in the specified country
   • Try alternative country or verify stock listing

2. "Validation error: stock must be a non-empty string"

   • Ensure stockSymbol is provided and not empty
   • Check for extra spaces or special characters

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.

---