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 json { "ticker": "KO", "includeAnalysis": true, "includeSummary": true, "outputFormat": "detailed" } ## Output Formats ### Minimal Format Returns only essential revenue values: json { "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: json { "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: json { "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 javascript const input = { "ticker": "AAPL" }; ### Minimal Output javascript const input = { "ticker": "TSLA", "outputFormat": "minimal", "includeAnalysis": false }; ### Compact with Analysis javascript const input = { "ticker": "GOOGL", "outputFormat": "compact", "includeAnalysis": true, "includeSummary": false }; ## Error Handling The actor handles various error scenarios: ### Invalid Ticker json { "ticker": "INVALID", "timestamp": "2025-08-11T11:41:36.868Z", "error": "No total revenue data available", "revenueData": null } ### Network/API Errors json { "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: json { "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. ---