# Investor Presentation Scraper (`datapilot/investor-presentation-scraper`) Actor Investor Presentation Scraper extracts investor decks, earnings presentations, SEC filings, annual reports, shareholder documents, and financial news from SEC EDGAR, company IR websites, Yahoo Finance, and Google News. Supports PDF discovery, deduplication, and structured dataset export. - **URL**: https://apify.com/datapilot/investor-presentation-scraper.md - **Developed by:** [Data Pilot](https://apify.com/datapilot) (community) - **Categories:** AI, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.50 / 1,000 scraped results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## ๐Ÿ“Š Investor Presentation Scraper An Apify Actor that aggregates **Investor Presentation** data, financial filings, and corporate news from multiple authoritative sources โ€” SEC EDGAR, Yahoo Finance, and Google News. Enter a company name and get back structured **Investor Presentation** records, earnings reports, SEC filings, and related financial news in one unified dataset. Whether you're conducting due diligence, tracking a competitor's **Investor Presentation** activity, or building a financial intelligence pipeline, this actor delivers comprehensive data efficiently. --- ### ๐Ÿ“‹ Table of Contents - [Features](#-features) - [Data Sources](#-data-sources) - [How It Works](#-how-it-works) - [Input](#-input) - [Output](#-output) - [Use Cases](#-use-cases) - [Quick Start](#-quick-start) - [Technical Stack](#-technical-stack) - [Changelog](#-changelog) - [Support](#-support) --- ### ๐Ÿ”ฅ Features - โœ… **Multi-Source Aggregation** โ€” Collects **Investor Presentation** data from SEC EDGAR, Yahoo Finance, and Google News in one run - โœ… **SEC EDGAR Integration** โ€” Searches 8 filing types (8-K, 10-K, 10-Q, DEF14A, S-1, 424B4, SC13G, SC13D) for **Investor Presentation** documents - โœ… **Investor Keyword Search** โ€” Targets "investor presentation", "earnings presentation", "annual report", and "roadshow" keywords on EDGAR - โœ… **Yahoo Finance News** โ€” Fetches financial news and press releases per company ticker - โœ… **Google News RSS** โ€” Searches 10 financial keyword combinations per company - โœ… **Deduplication** โ€” Removes duplicate records by URL + title across all sources - โœ… **Configurable Sources** โ€” Enable or disable each data source independently - โœ… **Rate Limiting** โ€” Polite delays between API requests to avoid blocks - โœ… **Error Handling** โ€” Graceful per-source error recovery with detailed logging - โœ… **Dataset Integration** โ€” Pushes all **Investor Presentation** records to Apify dataset in real time --- ### ๐ŸŒ Data Sources | Source | Type | Coverage | |--------|------|----------| | **SEC EDGAR** | Official filings | 8-K, 10-K, 10-Q, DEF14A, S-1, 424B4, SC13G, SC13D + investor presentations | | **Yahoo Finance** | News & press releases | Company ticker news, financial announcements | | **Google News RSS** | News articles | Earnings, roadshows, shareholder updates, IPO news | #### SEC EDGAR Search Keywords - `investor presentation` - `earnings presentation` - `annual report` - `roadshow` #### Google News Search Combinations - `{company} investor presentation` - `{company} annual report` - `{company} earnings` - `{company} quarterly results` - `{company} financial results` - `{company} investor day` - `{company} shareholder` - `{company} SEC filing` - `{company} IPO` - `{company} roadshow` --- ### โš™๏ธ How It Works 1. **Input Parsing** โ€” Read company name, max results, and selected sources 2. **SEC EDGAR Search** โ€” Query EDGAR full-text search for 8 filing types + investor presentation keywords + company browse 3. **Yahoo Finance Search** โ€” Search company name, extract tickers, fetch news per ticker 4. **Google News Search** โ€” Query RSS feed for 10 financial keyword combinations 5. **Aggregation** โ€” Merge results from all selected sources into one list 6. **Deduplication** โ€” Remove duplicates by URL + title combination 7. **Trim to Limit** โ€” Apply `maxResults` cap 8. **Dataset Push** โ€” Push all unique **Investor Presentation** records with timestamps 9. **Completion** โ€” Log total records saved --- ### ๐Ÿ“ฅ Input | Field | Type | Default | Description | |-------|------|---------|-------------| | `company` | string | **Required** | Company name to search **Investor Presentation** data for | | `maxResults` | integer | `1000` | Maximum total records to return across all sources | | `sources` | array | `["edgar", "yahoo", "google_news"]` | Which sources to enable | #### Example Input โ€” Full Search ```json { "company": "Tesla", "maxResults": 1000, "sources": ["edgar", "yahoo", "google_news"] } ```` #### Example Input โ€” SEC Only ```json { "company": "Apple Inc", "maxResults": 500, "sources": ["edgar"] } ``` #### Example Input โ€” News Only ```json { "company": "Microsoft", "maxResults": 300, "sources": ["yahoo", "google_news"] } ``` *** ### ๐Ÿ“ค Output Each **Investor Presentation** or filing record contains: | Field | Type | Description | |-------|------|-------------| | `source` | string | Data source (e.g., `SEC EDGAR (8-K)`, `Yahoo Finance`, `Google News`) | | `company` | string | Company name | | `filing_type` | string | Filing or content type (e.g., `8-K`, `10-K`, `News Article`) | | `title` | string | Title of the filing or **Investor Presentation** | | `date` | string | Publication or filing date | | `period` | string | Period of report (SEC filings only) | | `description` | string | Brief description or publisher info | | `url` | string | Direct link to the filing or article | | `cik` | string | SEC CIK identifier (EDGAR records only) | | `accession` | string | SEC accession number or ticker symbol | | `scraped_at` | string | ISO 8601 UTC timestamp | #### Example Output โ€” SEC EDGAR ```json { "source": "SEC EDGAR (8-K)", "company": "Tesla, Inc.", "filing_type": "8-K", "title": "8-K โ€” Tesla, Inc.", "date": "2024-10-23", "period": "2024-09-30", "description": "SEC 8-K filing", "url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=1318605&type=8-K", "cik": "1318605", "accession": "0001318605-24-000056", "scraped_at": "2025-03-22T12:34:56Z" } ``` #### Example Output โ€” Investor Presentation (EDGAR) ```json { "source": "SEC EDGAR (Presentation)", "company": "Tesla, Inc.", "filing_type": "8-K", "title": "Investor Presentation โ€” Tesla, Inc.", "date": "2024-01-15", "period": "", "description": "Investor document: investor presentation", "url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=1318605&type=8-K", "cik": "1318605", "accession": "0001318605-24-000012", "scraped_at": "2025-03-22T12:34:56Z" } ``` #### Example Output โ€” Yahoo Finance ```json { "source": "Yahoo Finance (TSLA)", "company": "Tesla", "filing_type": "News", "title": "Tesla Q3 Earnings Beat Expectations", "date": "2024-10-24", "period": "", "description": "Reuters", "url": "https://finance.yahoo.com/news/...", "cik": "", "accession": "TSLA", "scraped_at": "2025-03-22T12:34:56Z" } ``` #### Example Output โ€” Google News ```json { "source": "Google News", "company": "Tesla", "filing_type": "News Article", "title": "Tesla Investor Day 2024: Key Takeaways", "date": "2024-03-01 09", "period": "", "description": "Source: Bloomberg | Query: Tesla investor presentation", "url": "https://news.google.com/...", "cik": "", "accession": "", "scraped_at": "2025-03-22T12:34:56Z" } ``` *** ### ๐ŸŽฏ Use Cases - ๐Ÿ’ผ **Due Diligence** โ€” Gather all **Investor Presentation** filings and news before investment decisions - ๐Ÿ“ˆ **Competitive Intelligence** โ€” Track competitor **Investor Presentation** activity and earnings announcements - ๐Ÿฆ **Financial Research** โ€” Aggregate SEC filings and **Investor Presentation** documents for analysis - ๐Ÿค– **Financial Data Pipelines** โ€” Feed structured **Investor Presentation** data into BI tools or AI models - ๐Ÿ“ฐ **News Monitoring** โ€” Track company-specific financial news across multiple sources - ๐Ÿงพ **Regulatory Research** โ€” Collect SEC filings for compliance and regulatory analysis - ๐Ÿ“Š **Market Intelligence** โ€” Monitor roadshow activity, IPOs, and shareholder communications *** ### ๐Ÿš€ Quick Start 1. **Open on Apify** โ€” Visit the actor page and click **Try for free** 2. **Set Company Name** โ€” Enter the company name in the `company` field 3. **Choose Sources** โ€” Select which sources to include (`edgar`, `yahoo`, `google_news`) 4. **Set Limit** โ€” Configure `maxResults` based on how much data you need 5. **Run the Actor** โ€” Click Start and monitor progress in the logs 6. **Download Results** โ€” Export the **Investor Presentation** dataset as JSON, CSV, or Excel #### Sample Log Output ``` Starting scrape for: 'Tesla' | limit=1000 [SEC EDGAR] Searching: Tesla EDGAR total: 412 [Yahoo Finance] Searching: Tesla Yahoo total: 280 [Google News] Searching: Tesla Google News total: 198 Pushing 890 unique items to dataset... Done! ``` *** ### ๐Ÿงฐ Technical Stack | Component | Technology | |-----------|------------| | HTTP Requests | `requests` library | | HTML Parsing | (`lxml`) + XML parser | | SEC EDGAR | Full-text search API + Browse API | | Yahoo Finance | Query API v1 (`/v1/finance/search`) | | Google News | RSS feed (`news.google.com/rss`) | | Async | `asyncio` | | Rate Limiting | 0.3โ€“0.5s delays between requests | | Platform | Apify Actor (serverless, scalable) | *** ### ๐Ÿ“ฆ Changelog #### v1.0.0 โ€” Initial Release - SEC EDGAR integration: 8 filing types (8-K, 10-K, 10-Q, DEF14A, S-1, 424B4, SC13G, SC13D) - EDGAR investor presentation keyword search (4 keywords) - EDGAR company browse scraping - Yahoo Finance news search with multi-ticker support - Google News RSS search with 10 financial keyword combinations - Multi-source aggregation into unified **Investor Presentation** dataset - Deduplication by URL + title - Configurable source selection (`edgar`, `yahoo`, `google_news`) - Configurable result limit (up to 1,000+) - ISO 8601 timestamp on all records - Rate limiting (0.3โ€“0.5s delays) - Per-source error handling and logging *** ### ๐Ÿง‘โ€๐Ÿ’ป Support & Feedback - **Issues & Ideas** โ€” Open a ticket on the Apify Actor issue tracker - **Documentation** โ€” Visit [Apify Docs](https://docs.apify.com) for platform guides - **Tips** โ€” Use the exact registered company name for best EDGAR results - **SEC Search** โ€” For private companies, use `google_news` and `yahoo` sources only *** > โš ๏ธ **Disclaimer:** This actor collects publicly available **Investor Presentation** data and financial filings. Please ensure your usage complies with the terms of service of each data source. Intended for research and informational purposes only. # Actor input Schema ## `company` (type: `string`): Company to search for (e.g. 'Apple Inc', 'Tesla', 'Microsoft'). ## `maxResults` (type: `integer`): Maximum number of unique results to return. ## `sources` (type: `array`): Which sources to scrape from. ## Actor input object example ```json { "company": "Apple Inc", "maxResults": 1000, "sources": [ "edgar", "yahoo", "google_news" ] } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "company": "Apple Inc" }; // Run the Actor and wait for it to finish const run = await client.actor("datapilot/investor-presentation-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "company": "Apple Inc" } # Run the Actor and wait for it to finish run = client.actor("datapilot/investor-presentation-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "company": "Apple Inc" }' | apify call datapilot/investor-presentation-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=datapilot/investor-presentation-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Investor Presentation Scraper", "description": "Investor Presentation Scraper extracts investor decks, earnings presentations, SEC filings, annual reports, shareholder documents, and financial news from SEC EDGAR, company IR websites, Yahoo Finance, and Google News. Supports PDF discovery, deduplication, and structured dataset export.", "version": "0.0", "x-build-id": "PQfPN2QwjCINicLNK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datapilot~investor-presentation-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datapilot-investor-presentation-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/datapilot~investor-presentation-scraper/runs": { "post": { "operationId": "runs-sync-datapilot-investor-presentation-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/datapilot~investor-presentation-scraper/run-sync": { "post": { "operationId": "run-sync-datapilot-investor-presentation-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "company" ], "properties": { "company": { "title": "Company Name", "type": "string", "description": "Company to search for (e.g. 'Apple Inc', 'Tesla', 'Microsoft')." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of unique results to return.", "default": 1000 }, "sources": { "title": "Data Sources", "uniqueItems": true, "type": "array", "description": "Which sources to scrape from.", "items": { "type": "string", "enum": [ "edgar", "yahoo", "google_news" ] }, "default": [ "edgar", "yahoo", "google_news" ] } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```