---
id: trendspy
version: "0.1.6"
license: MIT License Copyright (c) 2024 SDil Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the… (full text in the JSON record)
license_treatment: permissive
maintenance: dormant
---

# trendspy — A Python library for accessing Google Trends data

License: permissive · Maintenance: dormant · Downloads: 78.3K/mo

## 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 above — 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

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

- License: MIT License Copyright (c) 2024 SDil Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 78.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

google trends data python, search interest analysis, trending searches api, geographic trend analysis, real-time trends data, keyword popularity tracking, trends data extraction, google-trends, data-analysis, web-scraping

[View on SkillFed](https://skillfed.io/packages/trendspy) · [View on PyPI](https://pypi.org/project/trendspy/)