# Public Company Expansion Signals Scraper (`datapilot/public-company-expansion-signals-scraper`) Actor Monitor corporate signals from SEC EDGAR and Yahoo Finance by company or keyword. Track 8-K filings, acquisitions, partnerships, funding, expansions, product launches, financial results, regulatory events, and news. Extract summaries, dates, values, links, and key business insights. - **URL**: https://apify.com/datapilot/public-company-expansion-signals-scraper.md - **Developed by:** [Data Pilot](https://apify.com/datapilot) (community) - **Categories:** AI, Automation, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 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. 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 ## Public Company Expansion Signals Scraper 📈 **Public Company Expansion Signals Scraper** is a powerful Apify Actor designed to discover, detect, and analyze **Company Expansion Signals** from multiple authoritative sources including SEC EDGAR filings and Yahoo Finance. This tool provides comprehensive corporate intelligence including merger/acquisition signals, partnership announcements, facility expansions, funding rounds, and strategic growth indicators. Whether you're tracking investment opportunities, monitoring competitor moves, or conducting corporate intelligence research, the Public Company Expansion Signals Scraper delivers actionable **Company Expansion Signals** efficiently. With multi-source integration from SEC EDGAR (8-K filings) and Yahoo Finance, intelligent signal detection algorithms, financial value extraction, geographic tracking, data enrichment via web scraping, and deduplication, the Public Company Expansion Signals Scraper ensures comprehensive **Company Expansion Signals** discovery and analysis. It focuses on key **Company Expansion Signals** including signal type, announcement date, company information, financial details, and summary information, making it an essential tool for **Company Expansion Signals** research and corporate intelligence. --- ### 📋 Table of Contents - [Features](#-features) - [Data Sources](#-data-sources) - [How It Works](#-how-it-works) - [Input](#-input) - [Output](#-output) - [Technical Stack](#-technical-stack) - [Data Fields](#-data-fields) - [Signal Types](#-signal-types) - [Use Cases](#-use-cases) - [Quick Start](#-quick-start) - [Configuration](#-configuration) - [Performance](#-performance) - [Billing](#-billing) - [Important Notes](#-important-notes) - [Keywords](#-keywords) - [Changelog](#-changelog) - [Support](#-support) --- ### 🔥 Features - **SEC EDGAR Integration** – Direct scraping of SEC EDGAR 8-K filings for **Company Expansion Signals**. - **Yahoo Finance Integration** – Real-time news feed monitoring from Yahoo Finance for corporate announcements. - **Dual-Source Intelligence** – Aggregates signals from 2 major financial data sources simultaneously. - **Signal Detection** – Intelligent detection of 10 different expansion signal types. - **8-K Filing Analysis** – Extracts material events from SEC Form 8-K filings. - **Corporate News Monitoring** – Tracks latest corporate news and announcements. - **Acquisition Detection** – Identifies M&A transactions and acquisition announcements. - **Partnership Detection** – Detects joint ventures, partnerships, and collaborations. - **Facility Expansion** – Identifies new office, facility, plant, or location openings. - **Capital Raise Detection** – Detects IPO, funding rounds, and capital raises. - **International Expansion** – Identifies geographic expansion and market entry signals. - **Product Expansion** – Detects new product launches and service expansions. - **Workforce Tracking** – Monitors hiring, layoffs, and workforce changes. - **Regulatory Signals** – Identifies recalls, investigations, and regulatory actions. - **Financial Results** – Tracks earnings reports and financial guidance. - **Value Extraction** – Automatically extracts financial amounts mentioned in signals. - **Geographic Tracking** – Identifies target countries and regions for expansion. - **Summary Extraction** – Fetches and enriches summaries from detail pages. - **URL Capture** – Provides direct links to SEC filings and financial sources. - **Deduplication** – Removes duplicate signals across sources. - **Data Enrichment** – Combines snippet and summary for comprehensive signals. - **Sorting** – Results organized by company and signal type. - **Proxy Support** – Apify residential proxy support for reliability. - **Real-Time Dataset Push** – Pushes results to Apify Dataset with metadata. - **Detailed Logging** – Comprehensive logging of signal detection and processing. - **Asyncio-Friendly** – Non-blocking async/await architecture. --- ### 📊 Data Sources #### **1. SEC EDGAR (8-K Filings)** - **Authority**: Official U.S. Securities and Exchange Commission (SEC) database - **Coverage**: All SEC-registered public companies - **Data**: Material Events filed on Form 8-K within 4 business days - **Update Frequency**: Real-time as filings are submitted - **Material Events**: Acquisitions, bankruptcy, resignations, regulation FD, material news - **Historical Data**: Covers 2024-2026 date range #### **2. Yahoo Finance** - **Authority**: Yahoo Finance news aggregation - **Coverage**: Global public companies and markets - **Data**: Real-time financial news and announcements - **Update Frequency**: Continuously updated - **Sources**: Thousands of financial news outlets - **Scope**: Market news, corporate announcements, earnings reports --- ### ⚙️ How It Works The Public Company Expansion Signals Scraper accepts a company name or keyword to monitor for expansion signals. It simultaneously queries SEC EDGAR for 8-K filings and Yahoo Finance for recent news. For SEC filings, it extracts company name, filing date, and snippet information, then fetches additional summary from SEC detail pages. For Yahoo Finance, it fetches news headlines, publishers, dates, and article summaries. Each signal is analyzed to detect signal type (acquisition, partnership, facility, funding, etc.), extract financial values, identify target countries, and build enriched signal objects. Results are deduplicated and pushed to the dataset. A completion summary is logged. **Key Processing Steps:** 1. **Input Parsing** – Accept company keyword 2. **Proxy Setup** – Configure Apify residential proxy 3. **SEC EDGAR Query** – Search 8-K filings by keyword 4. **Yahoo Finance Query** – Search news by keyword 5. **SEC Result Parsing** – Extract company, date, CIK, snippet 6. **Yahoo Finance Parsing** – Extract title, publisher, date, link 7. **Summary Fetching** – Fetch full summaries from detail URLs 8. **Signal Detection** – Analyze text to detect signal type 9. **Value Extraction** – Extract financial amounts 10. **Country Identification** – Identify target geographies 11. **Data Enrichment** – Combine snippet and summary 12. **Deduplication** – Remove duplicates by company + snippet 13. **Dataset Push** – Push unique signals in batch 14. **Summary Logging** – Report statistics **Key Benefits:** - Monitor **Company Expansion Signals** from multiple official sources - Detect investment opportunities early - Track competitor strategic moves - Understand corporate strategy shifts - Identify high-growth companies - Stay informed on material corporate events --- ### 📥 Input The Actor accepts the following input parameters: | Field | Type | Default | Description | |-------|------|---------|-------------| | `keyword` | string | required | Company name to monitor for **Company Expansion Signals** | | `useApifyProxy` | boolean | `true` | Enable Apify residential proxies | | `apifyProxyGroups` | array | `["RESIDENTIAL"]` | Proxy group configuration | **Example Input:** ```json { "keyword": "Apple", "useApifyProxy": true } ```` **Monitor Tech Company:** ```json { "keyword": "Microsoft" } ``` **Track Auto Company:** ```json { "keyword": "Tesla" } ``` *** ### 📤 Output The Actor pushes **Company Expansion Signals** records with the following structure: **Company Signal Record:** | Field | Type | Description | |-------|------|-------------| | `company` | string | Company name from signal | | `period` | string | Period of report (for SEC filings) | | `date` | string | Signal announcement date (YYYY-MM-DD) | | `signal` | string | Type of signal detected (Acquisition, Partnership, etc.) | | `snippet` | string | Brief headline or filing snippet | | `summary` | string | Detailed summary from source (up to 400 chars) | | `value` | string | Financial value mentioned (if any) | | `country` | string | Target country/region identified | | `publisher` | string | News publisher (for Yahoo Finance) | | `detail_url` | string | Direct link to filing or article | | `source` | string | Data source (SEC EDGAR or Yahoo Finance) | | `keyword` | string | Search keyword used | | `scraped_at` | string | ISO 8601 scrape timestamp | **Example Company Signal Record:** ```json { "company": "Microsoft Corporation", "period": "2025-02-01", "date": "2025-02-10", "signal": "Acquisition", "snippet": "Microsoft Completes Acquisition of CloudTech Systems", "summary": "Microsoft today announced the completion of its acquisition of CloudTech Systems, a leading provider of cloud infrastructure solutions. The acquisition strengthens Microsoft's cloud portfolio...", "value": "$2.5 billion", "country": "USA", "publisher": "Reuters", "detail_url": "https://www.sec.gov/cgi-bin/browse-edgar?...", "source": "SEC EDGAR", "keyword": "Microsoft", "scraped_at": "2025-02-14T12:00:00" } ``` **Example Multiple Signals (Batch):** ```json [ { "company": "Apple Inc.", "date": "2025-02-12", "signal": "International Expansion", "snippet": "Apple Expands Retail Presence in Asia-Pacific Region", "summary": "Apple announced plans to open 15 new retail stores across Asia-Pacific markets...", "value": "$500 million", "country": "Asia", "source": "Yahoo Finance", "keyword": "Apple", "scraped_at": "2025-02-14T12:00:00" }, { "company": "Google LLC", "date": "2025-02-08", "signal": "Capital Raise", "snippet": "Google Raises $1 Billion for AI Research Initiative", "summary": "Alphabet announces allocation of $1 billion capital for AI research...", "value": "$1 billion", "country": "USA", "source": "SEC EDGAR", "keyword": "Google", "scraped_at": "2025-02-14T12:00:00" } ] ``` *** ### 🧰 Technical Stack - **APIs:** SEC EDGAR API (search-index), Yahoo Finance API - **Web Scraping:** BeautifulSoup for HTML parsing - **HTTP Client:** httpx for async HTTP requests - **Pattern Matching:** Regex for signal detection, value extraction, country identification - **Date Parsing:** datetime for standardized formatting - **Query Building:** urllib.parse for URL encoding - **Async:** asyncio for non-blocking operations - **Deduplication:** Set-based tracking by company + snippet - **Proxy:** Apify Proxy with RESIDENTIAL configuration - **Logging:** Apify Actor logging system - **Platform:** Apify Actor serverless environment *** ### 📊 Data Fields Explained #### **Company & Timeline** - **company**: Company name from signal - **period**: Period of report (SEC filings) - **date**: Signal announcement date #### **Signal Information** - **signal**: Type of expansion signal detected - **snippet**: Brief headline or description - **summary**: Detailed summary from source #### **Financial & Geographic** - **value**: Financial amount mentioned - **country**: Target country/region #### **Reference** - **detail\_url**: Link to full filing/article - **publisher**: News source (if applicable) - **source**: Data origin (SEC EDGAR or Yahoo Finance) - **keyword**: Search term used *** ### 🎯 Signal Types The Public Company Expansion Signals Scraper detects 10 **Company Expansion Signals** types: #### **1. Acquisition** Merger/acquisition announcements, buyouts, takeovers #### **2. Partnership** Joint ventures, strategic alliances, collaborations, partnerships #### **3. New Facility** New offices, facilities, plants, locations, stores, factories, hubs, campuses, data centers #### **4. Capital Raise** IPO announcements, funding rounds (Series A/B/C), capital raises, investment rounds #### **5. International Expansion** Global expansion, overseas markets, new country entries, market launches, region expansion #### **6. Product Expansion** New products, product launches, new services, new divisions, new lines, new models, features #### **7. Workforce** Hiring announcements, headcount changes, workforce expansion, layoffs, workforce reductions #### **8. Regulatory** Recalls, safety investigations, lawsuits, fines, penalties, regulatory actions, NHTSA/FTC/SEC actions #### **9. Financial Results** Earnings reports, revenue, profits, losses, quarterly/annual results, forecasts, guidance #### **10. General Expansion** Generic expansion, growth initiatives, scaling announcements *** ### 🎯 Use Cases - **Investment Research** – Monitor **Company Expansion Signals** for investment opportunities - **Competitive Intelligence** – Track competitor **Company Expansion Signals** and strategic moves - **Due Diligence** – Research **Company Expansion Signals** before acquisitions - **Portfolio Monitoring** – Track portfolio company **Company Expansion Signals** - **Market Analysis** – Analyze industry trends via **Company Expansion Signals** - **Strategic Planning** – Understand **Company Expansion Signals** for business strategy - **Risk Assessment** – Identify risk signals (recalls, regulations, layoffs) - **News Monitoring** – Automated monitoring of **Company Expansion Signals** - **Acquisition Alerts** – Get notified of M\&A activity in your space - **Funding Tracking** – Monitor funding rounds and capital raises - **Growth Identification** – Identify high-growth companies via signals - **Opportunity Detection** – Detect partnership and collaboration opportunities - **Market Entry** – Understand market entry strategies via expansion signals - **Supply Chain** – Monitor suppliers/customers for strategic changes - **Financial Analysis** – Track financial performance via earnings signals *** ### 🚀 Quick Start #### **1. Prepare Input** Go to Apify Console and enter: ```json { "keyword": "Amazon", "useApifyProxy": true } ``` #### **2. Run the Actor** Click **Start** button. The Actor will: - Query SEC EDGAR for 8-K filings - Query Yahoo Finance for news - Extract signal information - Fetch summaries from sources - Detect signal types - Deduplicate and push to Dataset #### **3. Monitor Progress** Console shows: ``` Initializing corporate intelligence monitor for company: 'Amazon' Apify Proxy integrated successfully. [1] Scraping SEC EDGAR (8-K Filings) Found 12 raw 8-K filings from SEC Index. [2] Scraping Yahoo Finance Feed Found 28 feed articles — extracting text subsets... Successfully processed and stored 35 corporate signaling records! ``` #### **4. View & Download Results** - **Results Tab**: All **Company Expansion Signals** with full details - **Export**: JSON, CSV, Excel - **Filter**: By signal type or date - **Sort**: By signal type or value *** ### ⚙️ Configuration #### **Company Monitoring** Large Cap: ```json { "keyword": "Tesla" } ``` Mid Cap: ```json { "keyword": "Datadog" } ``` *** ### 📈 Performance #### **Processing Speed** - \~20-30 seconds for complete search - 8-K filings typically 5-25 results - Yahoo Finance news typically 30 results - Summary fetching adds 2-5 seconds - Total time: 30-40 seconds #### **Resource Usage** - Memory: ~150-250MB - CPU: ~35-45% during processing - Network: ~5-8MB per search - API calls: 2 searches + N summary fetches (N = # results) *** ### 💰 Billing #### **Batch Billing** - **Billing Model:** Batch push (not per-signal PPE) - **Typical Cost:** Single operation per search - **Efficiency:** High efficiency, bulk processing *** ### ⚠️ Important Notes #### **Legal & Compliance** - **Fair Use**: Respects SEC EDGAR and Yahoo Finance ToS - **Attribution**: Respects data source copyrights - **Accuracy**: Data as filed/reported by sources - **Verification**: Always verify with official sources - **Rate Limiting**: Includes appropriate delays #### **Data Quality** - **Freshness**: Real-time from SEC and Yahoo Finance - **Completeness**: Depends on source coverage - **Accuracy**: Official source data - **Reliability**: SEC EDGAR and Yahoo Finance highly reliable - **Verification**: Always verify with company investor relations #### **Best Practices** - Verify signals with SEC EDGAR directly - Check Yahoo Finance for news context - Review company investor relations pages - Analyze in context of company strategy - Track signals over time for patterns - Combine with financial analysis - Verify valuations independently - Consult with investment professionals - Consider signal confidence levels - Build portfolio of signal types ### 📦 Changelog **Initial Release:** - SEC EDGAR 8-K filing integration - Yahoo Finance news feed integration - Multi-source simultaneous querying - Company/keyword-based search - 8-K filing extraction (company, date, CIK, snippet) - Yahoo Finance extraction (title, publisher, date, link) - Summary page fetching and enrichment - 10-type signal detection algorithm - Acquisition detection - Partnership detection - Facility expansion detection - Capital raise detection - International expansion detection - Product expansion detection - Workforce change detection - Regulatory signal detection - Financial results detection - General expansion detection - Financial value extraction from text - Country/region identification - Text cleaning and normalization - Date parsing and standardization - Deduplication by company + snippet - Data enrichment combining snippet + summary - Real-time Dataset push - Detailed progress logging - Comprehensive error handling - Asyncio executor support *** ### 🧑‍💻 Support & Feedback - **Issues:** Submit via Apify console with company name - **Documentation:** Check Actor details page - **Community:** Apify forum discussions - **Feature Requests:** Suggest improvements - **Bug Reports:** Include company and error details *** #### **Output Access** - **Results Tab**: All company signals with full details - **Export**: JSON, CSV, Excel - **Filter**: By signal type or source - **API**: Query via Apify API *** ### 📄 License & Legal **Terms of Use:** - Use for legitimate business and research - Respect SEC EDGAR and Yahoo Finance ToS - Respect data source copyrights - Don't republish without permission - Comply with SEC and financial regulations - Use data ethically and responsibly **Disclaimer:** Public Company Expansion Signals Scraper is provided as-is for intelligence purposes. Users are responsible for compliance with SEC and Yahoo Finance ToS and applicable regulations. Always verify information with official SEC EDGAR filings and company investor relations materials. *** ### 🎉 Get Started Today **Deploy now for **Company Expansion Signals** research!** Use for: - 📊 Investment Research - 🔍 Competitive Intelligence - 💡 Due Diligence - 📈 Trend Analysis - 🎯 Signal Monitoring **Perfect for:** - Investors - Analysts - Business Development - Consultants - Researchers *** **Last Updated:** February 2025\ **Version:** 1.0.0\ **Status:** Production Ready\ **Platform:** Apify Actor\ **Architecture:** Async/Await\ **Data Sources:** SEC EDGAR, Yahoo Finance *** ### 📚 Related Tools - Franchise Expansion Tracker - Public Procurement Intelligence Hub - Product Recall Monitor - News Mention Alert Engine *** ### 📈 Company Intelligence Excellence This Actor is optimized for **Company Expansion Signals** research with: - ✅ Multi-source SEC + Yahoo Finance integration - ✅ 10-type signal detection - ✅ Financial value extraction - ✅ Geographic tracking - ✅ Summary enrichment - ✅ Deduplication - ✅ Real-time Dataset push - ✅ Error recovery - ✅ Production-ready code # Actor input Schema ## `keyword` (type: `string`): Enter the public company name to track expansion signals (e.g., Tesla, Apple, Amazon, Microsoft). ## `useApifyProxy` (type: `boolean`): Highly recommended to prevent SEC EDGAR and Yahoo Finance from blocking the client. ## `apifyProxyGroups` (type: `array`): Residential proxies are ideal for bypassing cloud firewall filters. ## Actor input object example ```json { "keyword": "Tesla", "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } ``` # 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 = { "keyword": "Tesla" }; // Run the Actor and wait for it to finish const run = await client.actor("datapilot/public-company-expansion-signals-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 = { "keyword": "Tesla" } # Run the Actor and wait for it to finish run = client.actor("datapilot/public-company-expansion-signals-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 '{ "keyword": "Tesla" }' | apify call datapilot/public-company-expansion-signals-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=datapilot/public-company-expansion-signals-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Public Company Expansion Signals Scraper", "description": "Monitor corporate signals from SEC EDGAR and Yahoo Finance by company or keyword. Track 8-K filings, acquisitions, partnerships, funding, expansions, product launches, financial results, regulatory events, and news. Extract summaries, dates, values, links, and key business insights.", "version": "0.0", "x-build-id": "hAcv6kM7ZgYRVXr40" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datapilot~public-company-expansion-signals-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datapilot-public-company-expansion-signals-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~public-company-expansion-signals-scraper/runs": { "post": { "operationId": "runs-sync-datapilot-public-company-expansion-signals-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~public-company-expansion-signals-scraper/run-sync": { "post": { "operationId": "run-sync-datapilot-public-company-expansion-signals-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": [ "keyword" ], "properties": { "keyword": { "title": "Company Name / Keyword", "type": "string", "description": "Enter the public company name to track expansion signals (e.g., Tesla, Apple, Amazon, Microsoft)." }, "useApifyProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Highly recommended to prevent SEC EDGAR and Yahoo Finance from blocking the client.", "default": true }, "apifyProxyGroups": { "title": "Proxy Groups", "uniqueItems": true, "type": "array", "description": "Residential proxies are ideal for bypassing cloud firewall filters.", "items": { "type": "string", "enum": [ "RESIDENTIAL", "DATACENTER" ] }, "default": [ "RESIDENTIAL" ] } } }, "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 } } } } } } } } } } ```