CNN Business Stock Total Revenue Actor

A specialized Apify Actor that fetches total revenue data for US stock companies from CNN Business. This actor provides current and historical revenue information with detailed analysis and insights.

Overview

The CNN Business Stock Total Revenue Actor allows you to retrieve comprehensive revenue data for any US-listed stock ticker. It provides quarterly and annual revenue figures, percentage changes, and detailed financial analysis to help evaluate company performance.

Features

• Revenue Data: Current and previous quarter/annual revenue figures
• Growth Analysis: Percentage changes and trend analysis
• Flexible Output: Multiple output formats (minimal, compact, detailed)
• Rich Insights: Optional analysis, summaries, and definitions
• Error Handling: Robust error management with informative messages
• Data Validation: Automatic ticker symbol validation

Input Configuration

Required Parameters

Parameter	Type	Description
ticker	string	Stock ticker symbol (1-5 characters, e.g., "AAPL", "GOOGL")

Optional Parameters

Parameter	Type	Default	Description
includeAnalysis	boolean	true	Include summary, analysis, and definitions in response
includeSummary	boolean	true	Include list_summary and usage fields (when includeAnalysis is true)
outputFormat	string	"detailed"	Output format: "minimal", "compact", or "detailed"

Input Schema Example

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

Output Formats

Minimal Format

Returns only essential revenue values:

{
  "ticker": "KO",
  "timestamp": "2025-08-11T11:41:36.868Z",
  "current_quarter_value": 12715,
  "current_annual_value": 46766,
  "company_name": "Coca-Cola Company",
  "last_updated": "2025-08-11T08:08:37.026000+00:00"
}

Compact Format

Returns structured revenue and change data:

{
  "ticker": "KO",
  "timestamp": "2025-08-11T11:41:36.868Z",
  "revenue": {
    "current_quarter": 12715,
    "prev_quarter": 11159,
    "current_annual": 46766,
    "prev_annual": 45831
  },
  "changes": {
    "quarter_percentage": "13.94",
    "annual_percentage": "2.04"
  },
  "company_name": "Coca-Cola Company",
  "last_updated": "2025-08-11T08:08:37.026000+00:00"
}

Detailed Format (Default)

Returns complete revenue data with metadata and optional analysis:

{
  "ticker": "KO",
  "timestamp": "2025-08-11T11:41:36.868Z",
  "revenueData": {
    "current_quarter_value": 12715,
    "prev_quarter_value": 11159,
    "quarter_index": "2",
    "current_annual_value": 46766,
    "prev_annual_value": 45831,
    "annual_percentage_change": "2.04",
    "quarter_percentage_change": "13.94",
    "company_name": "Coca-Cola Company",
    "event_date": "2025-06-30",
    "last_updated": "2025-08-11T08:08:37.026000+00:00"
  },
  "metadata": {
    "sufficient_data": true,
    "has_analysis": true
  },
  "analysis": {
    "summary": {
      "title": "KO total revenue: $46.77B (annual), $12.71B (Q2)",
      "plain_text": "Total Revenue held flat since last year and increased 13.94% since last quarter.",
      "formatted_text": "Total Revenue <span class=neutral>held flat</span> since last year and <span class=inc>increased 13.94%</span> since last quarter."
    },
    "what_it_means": {
      "title": "What does this mean?",
      "formatted_text": "<span class=neutral>Flat</span> total revenue year-over-year, combined with <span class=inc>increasing</span> total revenue quarter-over-quarter is an indication the company has been able to grow revenue or total sales in the long-term.",
      "plain_text": "Flat total revenue year-over-year, combined with increasing total revenue quarter-over-quarter is an indication the company has been able to grow revenue or total sales in the long-term."
    },
    "definition": {
      "title": "What is total revenue?",
      "formatted_text": "Total revenue, or total sales, are all the receipts a company has received from its customers...",
      "plain_text": "Total revenue, or total sales, are all the receipts a company has received from its customers..."
    }
  }
}

Data Fields Explanation

Revenue Data Fields

Field	Type	Description
current_quarter_value	number	Current quarter revenue (in millions)
prev_quarter_value	number	Previous quarter revenue (in millions)
current_annual_value	number	Current annual revenue (in millions)
prev_annual_value	number	Previous annual revenue (in millions)
quarter_percentage_change	string	Quarterly revenue change percentage
annual_percentage_change	string	Annual revenue change percentage
quarter_index	string	Current quarter index (1, 2, 3, or 4)
event_date	string	Date of the financial event (YYYY-MM-DD)
company_name	string	Full company name
last_updated	string	Last update timestamp (ISO format)

Analysis Fields (when includeAnalysis = true)

Field	Description
summary	Brief revenue summary with growth indicators
what_it_means	Financial analysis and interpretation
definition	Explanation of total revenue concept
list_summary	Condensed summary for listings (when includeSummary = true)
usage	Explanation of why total revenue is important (when includeSummary = true)

Usage Examples

Basic Usage

const input = {
  "ticker": "AAPL"
};

Minimal Output

const input = {
  "ticker": "TSLA",
  "outputFormat": "minimal",
  "includeAnalysis": false
};

Compact with Analysis

const input = {
  "ticker": "GOOGL",
  "outputFormat": "compact",
  "includeAnalysis": true,
  "includeSummary": false
};

Error Handling

The actor handles various error scenarios:

Invalid Ticker

{
  "ticker": "INVALID",
  "timestamp": "2025-08-11T11:41:36.868Z",
  "error": "No total revenue data available",
  "revenueData": null
}

Network/API Errors

{
  "ticker": "AAPL",
  "timestamp": "2025-08-11T11:41:36.868Z",
  "error": "Connection timeout",
  "revenueData": null
}

Key-Value Store

The actor automatically saves a summary to the key-value store under the key REVENUE_SUMMARY:

{
  "ticker": "KO",
  "company_name": "Coca-Cola Company",
  "current_quarter_revenue": 12715,
  "current_annual_revenue": 46766,
  "quarter_change": "13.94",
  "annual_change": "2.04",
  "completedAt": "2025-08-11T11:41:36.868Z"
}

Best Practices

1. Ticker Validation: Use valid US stock ticker symbols (1-5 characters)
2. Output Format: Choose the appropriate format based on your needs:
   • Use minimal for basic integration
   • Use compact for structured data processing
   • Use detailed for comprehensive analysis
3. Analysis Control: Set includeAnalysis to false if you only need raw revenue data
4. Error Handling: Always check for the error field in the response
5. Rate Limiting: Be mindful of API rate limits when processing multiple tickers

Common Use Cases

• Financial Analysis: Evaluate company revenue growth and trends
• Investment Research: Compare revenue performance across companies
• Portfolio Management: Monitor revenue metrics for held stocks
• Financial Reporting: Generate revenue reports and summaries
• Market Research: Analyze sector revenue trends

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.

---