CNN Business Stock Price Actor Documentation

Overview

The CNN Business Stock Price Actor is a web scraping tool that fetches real-time stock price data and financial analysis from CNN Business. This actor provides comprehensive stock information including current prices, historical data, technical indicators, and market analysis.

Features

• Real-time Stock Prices: Get current stock prices with timestamps
• 52-Week Range Data: Access yearly high and low prices
• Technical Indicators: 200-day moving average calculations
• Market Analysis: Professional insights and momentum analysis
• Flexible Output Formats: Choose from detailed, compact, or minimal data structures
• Error Handling: Robust error management with detailed logging
• Data Validation: Built-in ticker symbol validation

Input Configuration

Required Parameters

Parameter	Type	Description	Example
ticker	string	Stock ticker symbol (1-5 characters)	"AAPL", "KO", "GOOGL"

Optional Parameters

Parameter	Type	Default	Description
includeAnalysis	boolean	true	Include summary, analysis, and definition data
includeSummary	boolean	true	Include list summary and usage information
outputFormat	string	"detailed"	Output format: "detailed", "compact", or "minimal"
waitForData	boolean	false	Only return results when sufficient data is available

Input Schema Example

{
  "ticker": "KO",
  "includeAnalysis": true,
  "includeSummary": true,
  "outputFormat": "detailed",
  "waitForData": false
}

Output Formats

Detailed Format (Default)

The detailed format provides comprehensive stock information including price data, metadata, and analysis.

{
  "ticker": "KO",
  "timestamp": "2025-08-11T11:09:06.187Z",
  "priceData": {
    "current_price": 70.34,
    "shares_outstanding": 4303.67,
    "yearly_low": 60.615,
    "yearly_high": 74.38,
    "moving_avg_200d": 67.85435,
    "event_date": "2025-08-08",
    "last_updated": "2025-08-10T07:34:51.334991+00:00"
  },
  "metadata": {
    "sufficient_data": true,
    "has_analysis": true
  },
  "analysis": {
    "summary": {
      "title": "Price Momentum",
      "formatted_text": "KO is trading <span class=neutral>in the middle</span> of its 52-week range <span class=inc>and above</span> its 200-day simple moving average.",
      "plain_text": "KO is trading in the middle of its 52-week range and above its 200-day simple moving average."
    },
    "what_it_means": {
      "title": "What does this mean?",
      "formatted_text": "Investors are still evaluating the share price, but the stock still appears to have some upward momentum. This is a <span class=inc>positive</span> sign for the stock's future value.",
      "plain_text": "Investors are still evaluating the share price, but the stock still appears to have some upward momentum. This is a positive sign for the stock's future value."
    },
    "definition": {
      "title": "What is share price?",
      "formatted_text": "When you own a share of stock, you own a piece of – or have equity in – a company...",
      "plain_text": "When you own a share of stock, you own a piece of – or have equity in – a company..."
    }
  }
}

Compact Format

The compact format provides essential price information in a streamlined structure.

{
  "ticker": "KO",
  "timestamp": "2025-08-11T11:09:06.187Z",
  "price": 70.34,
  "range_52w": {
    "low": 60.615,
    "high": 74.38
  },
  "moving_avg_200d": 67.85435,
  "last_updated": "2025-08-10T07:34:51.334991+00:00"
}

Minimal Format

The minimal format provides only the current price and last update information.

{
  "ticker": "KO",
  "timestamp": "2025-08-11T11:09:06.187Z",
  "current_price": 70.34,
  "last_updated": "2025-08-10T07:34:51.334991+00:00"
}

Data Fields Explained

Price Data Fields

• current_price: Current stock price in USD
• shares_outstanding: Total number of shares outstanding (in millions)
• yearly_low: Lowest price in the past 52 weeks
• yearly_high: Highest price in the past 52 weeks
• moving_avg_200d: 200-day simple moving average
• event_date: Date of the most recent trading event
• last_updated: Timestamp of when the data was last updated

Analysis Fields

• summary: Technical analysis summary with momentum indicators
• what_it_means: Interpretation of the current price action and trends
• definition: Educational content explaining stock price concepts
• list_summary: Formatted summary for display purposes
• usage: Explanation of why share price is important for investors

Metadata Fields

• sufficient_data: Boolean indicating if there's enough data for analysis
• has_analysis: Boolean indicating if analysis data is available
• ticker: Normalized ticker symbol (uppercase)
• timestamp: ISO timestamp when the data was retrieved

Error Handling

The actor includes comprehensive error handling for various scenarios:

Invalid Ticker Format

{
  "ticker": "INVALID",
  "timestamp": "2025-08-11T11:09:06.187Z",
  "error": "Ticker format validation failed",
  "priceData": null
}

No Data Available

{
  "ticker": "XYZ",
  "timestamp": "2025-08-11T11:09:06.187Z",
  "error": "No price data available",
  "priceData": null
}

Insufficient Data (when waitForData=true)

{
  "ticker": "ABC",
  "timestamp": "2025-08-11T11:09:06.187Z",
  "status": "insufficient_data",
  "message": "Skipped due to insufficient data and waitForData=true"
}

Usage Examples

Basic Usage

{
  "ticker": "AAPL"
}

Advanced Configuration

{
  "ticker": "TSLA",
  "includeAnalysis": true,
  "includeSummary": false,
  "outputFormat": "compact",
  "waitForData": true
}

Minimal Data Only

{
  "ticker": "GOOGL",
  "includeAnalysis": false,
  "outputFormat": "minimal"
}

Key-Value Store

The actor automatically saves a summary of the price data to the Apify Key-Value Store under the key PRICE_SUMMARY:

{
  "ticker": "KO",
  "current_price": 70.34,
  "market_cap": 302537.78,
  "price_range_52w": {
    "low": 60.615,
    "high": 74.38
  },
  "completedAt": "2025-08-11T11:09:06.187Z"
}

Best Practices

1. Ticker Validation: Always use valid US stock ticker symbols (1-5 uppercase letters)
2. Data Freshness: Check the last_updated field to ensure data currency
3. Error Handling: Always check for error fields in the response
4. Output Format: Choose the appropriate output format based on your needs
5. Analysis Data: Set includeAnalysis=false if you only need price data to reduce response size

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
• Email: pintoflowpt@gmail.com
• Apify Platform: You can also contact us directly through this platform.

---