Trendflow¶

A type-safe Python library for querying, streaming, and exporting Google Trends data.

The HTTP client returns raw JSON; parsing into dataclasses lives in trendflow._parsers, and the high-level GoogleTrendsFetcher (exposed as Client) ties it together. See Architecture for the full layout.

Getting started¶

• Installation — how to install Trendflow
• Architecture — layers (_trends_http, _parsers, _fetcher, models)
• Usage — how to use Trendflow
• API Reference — auto-generated API documentation