Class GoogleTrendsFetcher

Fetches data via the in-tree Google Trends HTTP session.

Implements

TrendsFetcher

Index

Constructors

Accessors

Methods

geoList interestByRegion interestOverTime relatedQueries suggestions trendingNow

Constructors

constructor

new GoogleTrendsFetcher(options?: ClientOptions): GoogleTrendsFetcher
Parameters
- options: ClientOptions = {}
Returns GoogleTrendsFetcher
- Defined in src/fetcher.ts:117

Accessors

currentProxy

get currentProxy(): string | undefined
The proxy currently pinned for queries, if a pool is configured.

Returns string | undefined
- Defined in src/fetcher.ts:142

Methods

geoList

geoList(): Promise<unknown>
Every region Google accepts: [code, name, slug] per country, each with its subregions. Useful for validating a geo before querying it.

Returns Promise<unknown>
- Defined in src/fetcher.ts:269

interestByRegion

interestByRegion(
    keyword: string,
    resolution: Resolution,
    region?: Region,
): Promise<InterestByRegionResult>
Parameters
- keyword: string
- resolution: Resolution
- region: Region = Region.US
Returns Promise<InterestByRegionResult>
Implementation of TrendsFetcher.interestByRegion
- Defined in src/fetcher.ts:188

interestOverTime

interestOverTime(
    keywords: string[],
    timeframe: Timeframe,
    region: Region,
): Promise<InterestOverTimeResult>
Parameters
- keywords: string[]
- timeframe: Timeframe
- region: Region
Returns Promise<InterestOverTimeResult>
Implementation of TrendsFetcher.interestOverTime
- Defined in src/fetcher.ts:171

relatedQueries

relatedQueries(keyword: string): Promise<RelatedResult>
Parameters
- keyword: string
Returns Promise<RelatedResult>
Implementation of TrendsFetcher.relatedQueries
- Defined in src/fetcher.ts:273

suggestions

suggestions(query: string): Promise<TopicSuggestion[]>
Entity suggestions for a partial query — the picker behind the UI's "Topic" results.

Pass a returned mid as a keyword to any query method to measure the topic rather than the literal phrase; a topic aggregates every spelling and translation of the same concept, so it usually scores far higher than the raw string.

Needs no cookie and no proxy: this RPC answers on IPs the widgetdata endpoints reject.
Parameters
- query: string
Returns Promise<TopicSuggestion[]>
Implementation of TrendsFetcher.suggestions
- Defined in src/fetcher.ts:259

trendingNow

trendingNow(
region?: Region | string & {},
options?: { backend?: TrendingBackend; window?: number },
): Promise<TrendingResult>
Trending searches for a region. Accepts any country code, not a fixed list, and worldwide works too.

backend selects the source:
- "rpc" (default via "auto") — 50 items with growth percentages and volume.
- "rss" — 10 items with the news articles behind each trend, which the RPC does not carry, but no growth figures. window does not apply: Google ignores it on the feed. There is no worldwide feed, so a country code is required.
- "auto" — the RPC, falling back to RSS if it fails. RPC first because it returns five times the items with real growth numbers; defaulting to RSS would quietly degrade results.
TrendingResult.source reports which one answered.
Parameters
- region: Region | string & {} = Region.WORLDWIDE
- options: { backend?: TrendingBackend; window?: number } = {}
Returns Promise<TrendingResult>
Implementation of TrendsFetcher.trendingNow
- Defined in src/fetcher.ts:224