trendspy

What it is and what it does

TrendsPy is a Python wrapper around Google Trends that lets you query search interest data, geographic trends, related queries, and real-time trending topics. It depends on numpy, pandas, requests, and python-dateutil to fetch and structure data from Google's API.

The library supports flexible timeframe formats (custom intervals, date ranges, hourly precision), geographic filtering down to city level, category-based searches, and batch retrieval of historical trending data for multiple keywords. It also includes proxy support for network configuration. The package is in Beta status and has not been actively maintained since its initial release in late 2024.

Use it for:

• Track search interest trends for keywords over time to understand seasonal demand or emerging topics.
• Analyze geographic distribution of search interest to identify regional market opportunities or audience concentration.
• Retrieve real-time trending searches and associated news articles to monitor current events and public interest.
• Compare search interest across multiple keywords, regions, and time periods in a single query for competitive analysis.
• Build a historical dataset of trending keywords with independent normalization for each keyword across multiple time windows.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Fetch and analyze Google Trends data including search interest over time, geographic distribution, related queries, and real-time trending searches.

Yes, if you need Google Trends data and accept the risks. Install friction is low and the API surface is straightforward. However, the project is dormant (no updates since December 2024), so be prepared to fork or patch if Google changes its endpoint or if bugs emerge. No known vulnerabilities as of the last security scan. Verify that your use case complies with Google's terms of service before deploying to production.

Install

trendspy on PyPI

pip install trendspy

uv add trendspy

poetry add trendspy

Installing trendspy

Before you install

Low install friction with standard dependencies (numpy, pandas, requests, python-dateutil). Maintenance is dormant—last commit was 2024-12-25 and the project has not been updated since its initial release cycle, so expect no active bug fixes or feature development.

License in practice

MIT License permits unrestricted use, modification, and distribution with minimal obligations—suitable for commercial and private projects.

Quickstart

pip install trendspy

from trendspy import Trends
tr = Trends()
df = tr.interest_over_time(['python', 'javascript'])
print(df)

Verify before relying

• Whether Google's terms of service permit programmatic access via this library or if rate limiting/blocking is likely in production use.
• Stability of the underlying Google Trends endpoint and whether breaking changes have occurred since the library's last update.

Package facts

Evidence: trendspy-0.1.6-py3-none-any.whl

Keywords: analytics, data-analysis, google-trends, trends

Tags

More Python Modules packages