Stock Analyst Price Data (Investing.com)

Overview

The Stock Analyst Price Data actor fetches analyst price target information for stocks from Investing.com. This actor provides comprehensive analyst consensus data including price targets, analyst counts, and investment recommendations for publicly traded companies across multiple international markets.

Features

• Multi-Market Support: Access analyst data for stocks from 45+ countries including major markets like US, UK, Germany, Japan, and emerging markets
• Comprehensive Price Targets: Retrieve high, low, average, and median analyst price targets
• Analyst Consensus: Get the number of analysts covering the stock and their overall recommendation
• Real-time Data: Fetch the most current analyst price target information available
• Structured Output: Clean, standardized JSON output format for easy integration
• Error Handling: Robust error handling with detailed logging and graceful failure management

Input Configuration

Required Parameters

Parameter	Type	Description	Example
stockSymbol	String	Stock ticker symbol (1-10 characters)	AAPL, MSFT, TSLA

Optional Parameters

Parameter	Type	Description	Default	Options
country	String	Country where the stock is listed	united states	See supported countries below

Supported Countries

The actor supports stocks from the following markets:

Americas: United States, Canada, Brazil, Mexico, Argentina, Chile, Colombia, Peru

Europe: United Kingdom, Germany, France, Italy, Spain, 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

Output Format

The actor returns a structured JSON object with the following fields:

Main Output Structure

{
  "stock": "AAPL",
  "country": "united states",
  "as_json": true,
  "retrieved_at": "2025-07-01T12:44:02.316946",
  "data_format": "analyst_price_target",
  "stock_symbol": "AAPL",
  "analyst_price_target": {
    "average": 228.6,
    "high": 300,
    "low": 170.62,
    "last_price": 205.17,
    "analyst_count": 49,
    "conclusion": 3
  },
  "has_data": true
}

Field Descriptions

Field	Type	Description
stock	String	The requested stock symbol
country	String	Country where the stock is listed (lowercase)
as_json	Boolean	Always true, indicates JSON format output
retrieved_at	String	ISO timestamp of when the data was fetched
data_format	String	Always "analyst_price_target"
stock_symbol	String	Stock symbol (same as stock field)
analyst_price_target	Object	Contains all analyst price target data
has_data	Boolean	Indicates if valid data was retrieved

Analyst Price Target Object

Field	Type	Description
average	Number	Average analyst price target
high	Number	Highest analyst price target
low	Number	Lowest analyst price target
last_price	Number	Current/last stock price
analyst_count	Integer	Number of analysts providing targets
conclusion	Integer	Analyst recommendation code (1-5 scale)

Recommendation Codes

The conclusion field uses a 1-5 scale:

• 1: Strong Buy
• 2: Buy
• 3: Hold
• 4: Sell
• 5: Strong Sell

Usage Examples

Basic Usage

{
  "stockSymbol": "AAPL"
}

With Specific Country

{
  "stockSymbol": "BBVA",
  "country": "spain"
}

Multiple Stocks (Run Separately)

For Apple:

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

For Tesla:

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

Integration Guide

Using the Apify API

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

# Run the actor
run_input = {
    "stockSymbol": "AAPL",
    "country": "united states"
}

run = client.actor("YOUR_ACTOR_ID").call(run_input=run_input)

# Fetch results
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"Stock: {item['stock']}")
    print(f"Average Target: ${item['analyst_price_target']['average']}")
    print(f"Current Price: ${item['analyst_price_target']['last_price']}")
    print(f"Analyst Count: {item['analyst_price_target']['analyst_count']}")

Using JavaScript/Node.js

const { ApifyClient } = require('apify-client');

const client = new ApifyClient({
    token: 'YOUR_API_TOKEN',
});

const input = {
    stockSymbol: 'MSFT',
    country: 'united states'
};

const run = await client.actor('YOUR_ACTOR_ID').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();

items.forEach((item) => {
    console.log(`Stock: ${item.stock}`);
    console.log(`Price Target Range: $${item.analyst_price_target.low} - $${item.analyst_price_target.high}`);
    console.log(`Average Target: $${item.analyst_price_target.average}`);
});

Error Handling

The actor includes comprehensive error handling for common scenarios:

Validation Errors

• Empty or invalid stock symbols
• Invalid country parameters
• Missing required fields

Runtime Errors

• Network connectivity issues
• Data source unavailable
• Rate limiting from Investing.com

Example Error Output

{
  "stock": "INVALID",
  "country": "united states",
  "as_json": true,
  "retrieved_at": "2025-07-01T12:44:02.316946",
  "data_format": "analyst_price_target",
  "stock_symbol": "INVALID",
  "analyst_price_target": null,
  "has_data": false,
  "error": "No analyst price target data retrieved"
}

Rate Limits and Best Practices

Performance Optimization

• Batch Processing: For multiple stocks, run separate actor instances rather than sequential calls
• Caching: Results are timestamped; consider caching data for repeated requests
• Error Recovery: Implement retry logic for temporary network failures

Rate Limiting

• Investing.com may impose rate limits on requests
• Consider delays between requests for large datasets
• Monitor actor run logs for rate limiting warnings

Country-Specific Considerations

• Some stocks may not have analyst coverage in all markets
• Emerging market stocks typically have fewer analyst reports
• Currency considerations: prices are returned in the stock's native currency

Data Freshness and Accuracy

• Update Frequency: Analyst data is typically updated when new research reports are published
• Source: Data is sourced directly from Investing.com
• Timeliness: The retrieved_at timestamp indicates when the data was fetched
• Accuracy: Data accuracy depends on Investing.com's data quality and update frequency

Common Use Cases

Investment Research

• Compare analyst consensus across multiple stocks
• Track changes in analyst sentiment over time
• Identify stocks with high analyst confidence (high analyst count)

Portfolio Management

• Assess if current positions align with analyst targets
• Identify potential buying opportunities (current price below average target)
• Monitor analyst recommendation changes

Financial Analysis

• Calculate potential upside/downside based on analyst targets
• Analyze analyst consensus reliability
• Compare analyst targets with technical analysis

Automated Trading Systems

• Trigger buy/sell signals based on analyst target changes
• Weight positions based on analyst confidence levels
• Filter stocks based on analyst coverage quality

Troubleshooting

Common Issues

No Data Returned

• Verify the stock symbol is correct and actively traded
• Check if the stock is listed in the specified country
• Some stocks may not have analyst coverage

Invalid Stock Symbol

• Ensure the symbol format matches the exchange (e.g., US stocks don't need suffixes)
• International stocks may require specific formatting

Country Mismatch

• Verify the stock is listed in the specified country
• Some multinational companies may be listed in multiple countries

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.

---