Stock Market Scrapper A powerful Apify Actor that fetches real-time stock market data from Yahoo Finance, including trending stocks, most actives, day gainers/losers, and 52-week performance leaders. ## 🚀 Features - Multiple Stock Categories: Access 6 different stock screening categories - Pagination Support: Fetch multiple pages of data (25 stocks per page) - Real-time Data: Get up-to-date market prices, volumes, and changes - Comprehensive Metrics: Includes P/E ratios, market cap, 52-week ranges, and more - Fast & Reliable: Async implementation for optimal performance ## 📊 Available Categories 1. Top Trending - Most searched and trending stocks on Yahoo Finance 2. Most Active - Stocks with highest trading volume 3. Day Gainers - Top performing stocks today 4. Day Losers - Worst performing stocks today 5. 52 Week Gainers - Best performers over the past year 6. 52 Week Losers - Worst performers over the past year ## 🔧 Input Configuration | Field | Type | Required | Description | Default | |-------|------|----------|-------------|---------| | category | String | Yes | Stock category to fetch | MOST_ACTIVES | | page | Integer | No | Number of pages to fetch (1-20) | 1 | ### Category Options - Top Trending - MOST_ACTIVES - DAY_GAINERS - DAY_LOSERS - FIFTY_TWO_WK_GAINERS - FIFTY_TWO_WK_LOSERS ## 📥 Input Example json { "category": "DAY_GAINERS", "page": 2 } ## 📤 Output Format The actor returns a JSON object containing: json { "category": "DAY_GAINERS", "count": 50, "data": [ { "Symbol": "AAPL", "Name": "Apple Inc.", "Price": 150.25, "Change": 2.50, "Change %": 1.69, "Volume": 52000000, "Avg Vol (3M)": 48500000, "Market Cap": 2400000000000, "P/E Ratio (TTM)": 28.5, "52 Wk High": 198.23, "52 Wk Low": 124.17, "52 Wk Change %": 15.23, "Sector": "Technology", "Industry": "Consumer Electronics", "Avg Rating": "Buy" } ] } ## 🎯 Use Cases - Market Research: Track market trends and identify opportunities - Portfolio Analysis: Monitor stocks across different categories - Trading Signals: Identify day gainers and losers for trading strategies - Data Analytics: Collect historical market data for analysis - Financial Reporting: Generate automated market reports - Investment Research: Research top-performing stocks ## 📈 Data Fields Explained | Field | Description | |-------|-------------| | Symbol | Stock ticker symbol | | Name | Company name | | Price | Current market price | | Change | Price change in dollars | | Change % | Price change percentage | | Volume | Trading volume for the day | | Avg Vol (3M) | Average 3-month trading volume | | Market Cap | Total market capitalization | | P/E Ratio (TTM) | Price-to-earnings ratio (trailing twelve months) | | 52 Wk High | Highest price in the last 52 weeks | | 52 Wk Low | Lowest price in the last 52 weeks | | 52 Wk Change % | Percentage change over 52 weeks | | Sector | Business sector | | Industry | Specific industry | | Avg Rating | Analyst average rating | ## 🔄 Update Frequency The actor fetches real-time data from Yahoo Finance. For the most current information: - Run during market hours (9:30 AM - 4:00 PM EST) - Data is typically delayed by 15-20 minutes for free tier - After-hours trading data may be available ## ⚡ Performance - Average Runtime: 5-15 seconds per page - Rate Limits: Respects Yahoo Finance API limits - Timeout: 60 seconds per request - Concurrent Requests: Sequential processing for stability ## 🛠️ Technical Details - Language: Python 3.11 - Framework: Apify SDK 1.7+ - HTTP Client: aiohttp (async) - Data Source: Yahoo Finance API ## 📝 Error Handling If an error occurs, the actor returns: json { "message": "error" } Common reasons for errors: - Invalid category name - Network connectivity issues - API rate limits exceeded - Invalid API credentials --- Note: This actor is for informational purposes only and should not be considered financial advice. Always conduct your own research before making investment decisions.