# TrendFlow

> TrendFlow queries Google Trends: interest over time, interest by region, related queries, trending searches, and topic lookup. It ships as a Python library (trendflow-py), a JavaScript library (trendflow), and a hosted MCP server at https://trendflow.mory.dev/mcp for ChatGPT, Claude, and Cursor.
> All figures are normalized relative interest, scaled 0-100 within a single result set — never absolute search volume. Results from separate queries are not comparable.

## JavaScript library (trendflow)

- [Installation](https://trendflow.mory.dev/docs/js/installation.md): Install TrendFlow and make your first Google Trends query, in Python or JavaScript.
- [Usage](https://trendflow.mory.dev/docs/js/usage.md): Query Google Trends: interest over time, interest by region, related queries, and exports — with runnable examples.
- [Trending searches](https://trendflow.mory.dev/docs/js/trending.md): Fetch what is trending right now, and choose between the RPC and RSS backends — one gives growth figures, the other the news articles behind each trend.
- [Topics and search suggestions](https://trendflow.mory.dev/docs/js/topics.md): Resolve a name to a Google Trends topic id. A topic aggregates every spelling and translation of a concept, so it measures far more search activity than a literal phrase.
- [Proxies and rate limits](https://trendflow.mory.dev/docs/js/proxies.md): Google rate-limits Trends by exit IP. Rotate through a proxy pool, and understand why rotation happens per query rather than per request.
- [Rate limits](https://trendflow.mory.dev/docs/js/rate-limits.md): What an HTTP 429 from Google Trends means, and how to stay under the limit without a proxy pool.
- [Errors](https://trendflow.mory.dev/docs/js/errors.md): The error types TrendFlow raises, what each one means, and which are worth retrying.
- [Python and JavaScript parity](https://trendflow.mory.dev/docs/js/parity.md): What the Python and JavaScript libraries each support, side by side, and how the two APIs map onto each other.

## Python library (trendflow-py)

- [Installation](https://trendflow.mory.dev/docs/python/installation.md): Install TrendFlow and make your first Google Trends query, in Python or JavaScript.
- [Usage](https://trendflow.mory.dev/docs/python/usage.md): Query Google Trends: interest over time, interest by region, related queries, and exports — with runnable examples.
- [Trending searches](https://trendflow.mory.dev/docs/python/trending.md): Fetch what is trending right now, and choose between the RPC and RSS backends — one gives growth figures, the other the news articles behind each trend.
- [Topics and search suggestions](https://trendflow.mory.dev/docs/python/topics.md): Resolve a name to a Google Trends topic id. A topic aggregates every spelling and translation of a concept, so it measures far more search activity than a literal phrase.
- [Proxies and rate limits](https://trendflow.mory.dev/docs/python/proxies.md): Google rate-limits Trends by exit IP. Rotate through a proxy pool, and understand why rotation happens per query rather than per request.
- [Rate limits](https://trendflow.mory.dev/docs/python/rate-limits.md): What an HTTP 429 from Google Trends means, and how to stay under the limit without a proxy pool.
- [Python and JavaScript parity](https://trendflow.mory.dev/docs/python/parity.md): What the Python and JavaScript libraries each support, side by side, and how the two APIs map onto each other.

## Hosted service

- [MCP server](https://trendflow.mory.dev/docs/mcp): Connect ChatGPT, Claude, or Cursor to Google Trends.
- [API reference](https://trendflow.mory.dev/docs/api): Generated reference for both libraries.

## Optional

- [Full documentation as one file](https://trendflow.mory.dev/llms-full.txt)
- [Privacy](https://trendflow.mory.dev/privacy)
- [Terms](https://trendflow.mory.dev/terms)