First public release of TrendsPy - A Python library for accessing Google Trends data.
Key Features
Explore Google Trends
- Track interest over time with `interest_over_time()`
- Analyze geographic distribution via `interest_by_region()`
- Compare interest across different timeframes and regions (multirange support)
- Get related queries and topics with `related_queries()` and `related_topics()`
Real-Time Trending Topics
- Access current trending searches via `trending_now()` and `trending_now_by_rss()`
- Get related news articles with `trending_now_news_by_ids()`
- Retrieve historical data for 500+ trending keywords with independent normalization using `trending_now_showcase_timeline()`
Search Utilities
- Find category IDs with `categories()`
- Search for location codes with `geo()`
Flexible Time Formats
- Custom intervals: 'now 123-H', 'today 45-d'
- Date-based offsets: '2024-02-01 10-d'
- Standard ranges: '2024-01-01 2024-12-31'
Installation
bash
pip install trendspy
Requirements
- Python >=3.7
- requests >=2.25.0
- pandas >=1.2.0
- numpy >=1.19.0
- python-dateutil >=2.8.0
Breaking Changes
- First public release
Documentation
For detailed usage examples and API documentation, please refer to the `basic_usage.ipynb` notebook in the repository.
License
MIT License - see the LICENSE file for details.