JavaScript library
Query Google Trends from JavaScript — interest over time, interest by region, related queries, trending searches, and topic lookup, with proxy rotation built in.
Install trendflow, then start with Installation.
Guides
Installation
Install TrendFlow and make your first Google Trends query, in Python or JavaScript.
Usage
Query Google Trends: interest over time, interest by region, related queries, and exports — with runnable examples.
Trending searches
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
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
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
What an HTTP 429 from Google Trends means, and how to stay under the limit without a proxy pool.
Errors
The error types TrendFlow raises, what each one means, and which are worth retrying.
Python and JavaScript parity
What the Python and JavaScript libraries each support, side by side, and how the two APIs map onto each other.
Reference
The full API reference is generated from source and lives at https://dariomory.github.io/trendflow-js/. Source and issues are on GitHub.
