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

{
  "category": "DAY_GAINERS",
  "page": 2
}

📤 Output Format

The actor returns a JSON object containing:

{
  "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:

{
  "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.