pytrends-modern 0.2.3__tar.gz → 0.2.4__tar.gz

{pytrends_modern-0.2.3/pytrends_modern.egg-info → pytrends_modern-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytrends-modern
-Version: 0.2.3
+Version: 0.2.4
 Summary: Modern Google Trends API - Combining the best of pytrends, with RSS feeds, Selenium scraping, DrissionPage browser automation, and enhanced features
 Author: pytrends-modern contributors
 License: MIT

pytrends_modern-0.2.4/examples/test_timeframes.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python3
+"""
+Example: Using different timeframes with browser mode
+
+Test both 'today 1-m' (default) and 'today 12-m' (past 12 months)
+"""
+
+from pytrends_modern import TrendReq, BrowserConfig
+
+keyword = "Python"
+
+print("=" * 70)
+print("Testing Different Timeframes")
+print("=" * 70)
+
+# Test 1: Default timeframe (today 1-m)
+print("\n📊 Test 1: Default timeframe (past month)")
+config1 = BrowserConfig(
+    headless=False,
+    min_delay=2.0,
+    max_delay=4.0,
+)
+print(f"Timeframe: {config1.timeframe}")
+
+pytrends1 = TrendReq(browser_config=config1)
+pytrends1.kw_list = [keyword]
+df1 = pytrends1.interest_over_time()
+print(f"✓ Got {len(df1)} data points")
+print(df1.head())
+print(f"Date range: {df1.index.min()} to {df1.index.max()}")
+
+# Close first browser before opening second
+pytrends1._close_browser()
+del pytrends1
+
+# Test 2: Past 12 months
+print("\n📊 Test 2: Past 12 months")
+config2 = BrowserConfig(
+    headless=False,
+    min_delay=2.0,
+    max_delay=4.0,
+    timeframe='today 12-m'
+)
+print(f"Timeframe: {config2.timeframe}")
+
+pytrends2 = TrendReq(browser_config=config2)
+pytrends2.kw_list = [keyword]
+df2 = pytrends2.interest_over_time()
+print(f"✓ Got {len(df2)} data points")
+print(df2.head())
+print(f"Date range: {df2.index.min()} to {df2.index.max()}")
+
+print("\n✅ Both timeframes working!")
+print(f"\nPast month: {len(df1)} points")
+print(f"Past 12 months: {len(df2)} points")

{pytrends_modern-0.2.3 → pytrends_modern-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pytrends-modern"
-version = "0.2.3"
+version = "0.2.4"
 description = "Modern Google Trends API - Combining the best of pytrends, with RSS feeds, Selenium scraping, DrissionPage browser automation, and enhanced features"
 readme = "README.md"
 requires-python = ">=3.8"

{pytrends_modern-0.2.3 → pytrends_modern-0.2.4}/pytrends_modern/__init__.py

@@ -2,7 +2,7 @@
 pytrends-modern: Modern Google Trends API
 """
 
-__version__ = "0.2.3"
+__version__ = "0.2.4"
 __author__ = "pytrends-modern contributors"
 __license__ = "MIT"
 

{pytrends_modern-0.2.3 → pytrends_modern-0.2.4}/pytrends_modern/browser_config_camoufox.py

@@ -12,7 +12,6 @@ class BrowserConfig:
     
     ⚠️ LIMITATIONS:
     - Only 1 keyword supported (no comparison)
-    - Only 'today 1-m' timeframe supported
     - Only WORLDWIDE geo supported (no geo filtering)
     - Requires Google account login (first run)
     
@@ -35,6 +34,9 @@ class BrowserConfig:
         max_delay: Maximum delay between requests in seconds (default: 5)
         persistent_context: Keep browser profile between sessions (default: True)
                           Set to False to use fresh profile each time (helps avoid 429)
+        timeframe: Time range for trends data (default: 'today 1-m')
+                  - 'today 1-m': Past month
+                  - 'today 12-m': Past 12 months
     
     Example:
         >>> from pytrends_modern import TrendReq, BrowserConfig
@@ -68,6 +70,7 @@ class BrowserConfig:
         max_delay: float = 5.0,
         persistent_context: bool = True,
         custom_config: Optional[Dict[str, Any]] = None,
+        timeframe: str = 'today 1-m',
     ):
         self.headless = headless
         self.proxy_server = proxy_server
@@ -82,4 +85,5 @@ class BrowserConfig:
         self.max_delay = max_delay
         self.persistent_context = persistent_context
         self.custom_config = custom_config or {}
+        self.timeframe = timeframe
 

{pytrends_modern-0.2.3 → pytrends_modern-0.2.4}/pytrends_modern/request.py

@@ -92,7 +92,6 @@ class TrendReq:
                            
                            ⚠️ LIMITATIONS when using browser_config:
                            - Only 1 keyword supported (no comparison)
-                           - Only 'today 1-m' timeframe supported
                            - Only WORLDWIDE geo supported (no geo filtering)
                            - Requires Chrome/Chromium browser installed
         """
@@ -109,7 +108,7 @@ class TrendReq:
             warnings.warn(
                 "⚠️  Camoufox browser mode is EXPERIMENTAL and has limitations:\n"
                 "   - Only 1 keyword supported (no keyword comparison)\n"
-                "   - Only 'today 1-m' timeframe supported\n"
+                "   - Timeframe: 'today 1-m' (default) or 'today 12-m'\n"
                 "   - Only WORLDWIDE geo supported\n"
                 "   - Requires Google account login (first run)\n"
                 "   - Login session is saved for future runs",
@@ -354,7 +353,18 @@ class TrendReq:
         # Build URL
         import urllib.parse
         encoded_keyword = urllib.parse.quote(keyword)
-        url = f"https://trends.google.com/trends/explore?date=today%201-m&q={encoded_keyword}&hl=en-GB"
+        
+        # Get timeframe from config (default: 'today 1-m')
+        timeframe = getattr(self.browser_config, 'timeframe', 'today 1-m')
+        
+        # Build URL with or without date parameter
+        if timeframe == 'today 12-m':
+            # Past 12 months - no date parameter needed
+            url = f"https://trends.google.com/trends/explore?q={encoded_keyword}&hl=en-GB"
+        else:
+            # Default: today 1-m or custom timeframe
+            encoded_timeframe = urllib.parse.quote(timeframe)
+            url = f"https://trends.google.com/trends/explore?date={encoded_timeframe}&q={encoded_keyword}&hl=en-GB"
         
         try:
             # Navigate and wait for network idle

{pytrends_modern-0.2.3 → pytrends_modern-0.2.4}/pytrends_modern/request_async.py

@@ -216,7 +216,18 @@ class AsyncTrendReq:
         # Build URL
         import urllib.parse
         encoded_keyword = urllib.parse.quote(keyword)
-        url = f"https://trends.google.com/trends/explore?date=today%201-m&q={encoded_keyword}&hl=en-GB"
+        
+        # Get timeframe from config (default: 'today 1-m')
+        timeframe = getattr(self.browser_config, 'timeframe', 'today 1-m')
+        
+        # Build URL with or without date parameter
+        if timeframe == 'today 12-m':
+            # Past 12 months - no date parameter needed
+            url = f"https://trends.google.com/trends/explore?q={encoded_keyword}&hl=en-GB"
+        else:
+            # Default: today 1-m or custom timeframe
+            encoded_timeframe = urllib.parse.quote(timeframe)
+            url = f"https://trends.google.com/trends/explore?date={encoded_timeframe}&q={encoded_keyword}&hl=en-GB"
         
         try:
             # Navigate and wait for network idle

{pytrends_modern-0.2.3 → pytrends_modern-0.2.4/pytrends_modern.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytrends-modern
-Version: 0.2.3
+Version: 0.2.4
 Summary: Modern Google Trends API - Combining the best of pytrends, with RSS feeds, Selenium scraping, DrissionPage browser automation, and enhanced features
 Author: pytrends-modern contributors
 License: MIT

{pytrends_modern-0.2.3 → pytrends_modern-0.2.4}/pytrends_modern.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ examples/basic_usage.py
 examples/example_browser_mode.py
 examples/example_docker_usage.py
 examples/test_async_integration.py
+examples/test_timeframes.py
 pytrends_modern/__init__.py
 pytrends_modern/browser_config.py
 pytrends_modern/browser_config_camoufox.py