@shaivpidadi/trends-js 0.0.0-beta.6 → 0.0.0-beta.8

package/dist/cjs/helpers/googleTrendsAPI.js

@@ -0,0 +1,339 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoogleTrendsApi = void 0;
+const enums_1 = require("../types/enums");
+const request_1 = require("./request");
+const format_1 = require("./format");
+const constants_1 = require("../constants");
+const GoogleTrendsError_1 = require("../errors/GoogleTrendsError");
+class GoogleTrendsApi {
+    /**
+     * Get autocomplete suggestions for a keyword
+     * @param keyword - The keyword to get suggestions for
+     * @param hl - Language code (default: 'en-US')
+     * @returns Promise with array of suggestion strings
+     */
+    async autocomplete(keyword, hl = 'en-US') {
+        if (!keyword) {
+            return { data: [] };
+        }
+        const options = {
+            ...constants_1.GOOGLE_TRENDS_MAPPER[enums_1.GoogleTrendsEndpoints.autocomplete],
+            qs: {
+                hl,
+                tz: '240',
+            },
+        };
+        try {
+            const response = await (0, request_1.request)(`${options.url}/${encodeURIComponent(keyword)}`, options);
+            const text = await response.text();
+            // Remove the first 5 characters (JSONP wrapper) and parse
+            const data = JSON.parse(text.slice(5));
+            return { data: data.default.topics.map((topic) => topic.title) };
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                return { error: new GoogleTrendsError_1.NetworkError(error.message) };
+            }
+            return { error: new GoogleTrendsError_1.UnknownError() };
+        }
+    }
+    /**
+     * Get daily trending topics
+     * @param options - Options for daily trends request
+     * @returns Promise with trending topics data
+     */
+    async dailyTrends({ geo = 'US', lang = 'en' }) {
+        const defaultOptions = constants_1.GOOGLE_TRENDS_MAPPER[enums_1.GoogleTrendsEndpoints.dailyTrends];
+        const options = {
+            ...defaultOptions,
+            body: new URLSearchParams({
+                'f.req': `[[["i0OFE","[null,null,\\"${geo}\\",0,\\"${lang}\\",24,1]",null,"generic"]]]`,
+            }).toString(),
+            contentType: 'form'
+        };
+        try {
+            const response = await (0, request_1.request)(options.url, options);
+            const text = await response.text();
+            const trendingTopics = (0, format_1.extractJsonFromResponse)(text);
+            if (!trendingTopics) {
+                return { error: new GoogleTrendsError_1.ParseError() };
+            }
+            return { data: trendingTopics };
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                return { error: new GoogleTrendsError_1.NetworkError(error.message) };
+            }
+            return { error: new GoogleTrendsError_1.UnknownError() };
+        }
+    }
+    /**
+     * Get real-time trending topics
+     * @param options - Options for real-time trends request
+     * @returns Promise with trending topics data
+     */
+    async realTimeTrends({ geo = 'US', trendingHours = 4 }) {
+        const defaultOptions = constants_1.GOOGLE_TRENDS_MAPPER[enums_1.GoogleTrendsEndpoints.dailyTrends];
+        const options = {
+            ...defaultOptions,
+            body: new URLSearchParams({
+                'f.req': `[[["i0OFE","[null,null,\\"${geo}\\",0,\\"en\\",${trendingHours},1]",null,"generic"]]]`,
+            }).toString(),
+            contentType: 'form'
+        };
+        try {
+            const response = await (0, request_1.request)(options.url, options);
+            const text = await response.text();
+            const trendingTopics = (0, format_1.extractJsonFromResponse)(text);
+            if (!trendingTopics) {
+                return { error: new GoogleTrendsError_1.ParseError() };
+            }
+            return { data: trendingTopics };
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                return { error: new GoogleTrendsError_1.NetworkError(error.message) };
+            }
+            return { error: new GoogleTrendsError_1.UnknownError() };
+        }
+    }
+    async explore({ keyword, geo = 'US', time = 'now 1-d', category = 0, property = '', hl = 'en-US', }) {
+        const options = {
+            ...constants_1.GOOGLE_TRENDS_MAPPER[enums_1.GoogleTrendsEndpoints.explore],
+            qs: {
+                hl,
+                tz: '240',
+                req: JSON.stringify({
+                    comparisonItem: [
+                        {
+                            keyword,
+                            geo,
+                            time,
+                        },
+                    ],
+                    category,
+                    property,
+                }),
+            },
+            contentType: 'form'
+        };
+        try {
+            const response = await (0, request_1.request)(options.url, options);
+            const text = await response.text();
+            // Check if response is HTML (error page)
+            if (text.includes('<html') || text.includes('<!DOCTYPE')) {
+                console.error('Explore request returned HTML instead of JSON');
+                return { widgets: [] };
+            }
+            // Try to parse as JSON
+            try {
+                // Remove the first 5 characters (JSONP wrapper) and parse
+                const data = JSON.parse(text.slice(5));
+                return data;
+            }
+            catch (parseError) {
+                console.error('Failed to parse explore response as JSON:', parseError instanceof Error ? parseError.message : 'Unknown parse error');
+                console.error('Response preview:', text.substring(0, 200));
+                return { widgets: [] };
+            }
+        }
+        catch (error) {
+            console.error('Explore request failed:', error);
+            return { widgets: [] };
+        }
+    }
+    // 
+    async interestByRegion({ keyword, startTime = new Date('2004-01-01'), endTime = new Date(), geo = 'US', resolution = 'REGION', hl = 'en-US', timezone = new Date().getTimezoneOffset(), category = 0 }) {
+        const formatDate = (date) => {
+            return date.toISOString().split('T')[0];
+        };
+        const formatTrendsDate = (date) => {
+            const pad = (n) => n.toString().padStart(2, '0');
+            const yyyy = date.getFullYear();
+            const mm = pad(date.getMonth() + 1);
+            const dd = pad(date.getDate());
+            const hh = pad(date.getHours());
+            const min = pad(date.getMinutes());
+            const ss = pad(date.getSeconds());
+            return `${yyyy}-${mm}-${dd}T${hh}\\:${min}\\:${ss}`;
+        };
+        const getDateRangeParam = (date) => {
+            const yesterday = new Date(date);
+            yesterday.setDate(date.getDate() - 1);
+            const formattedStart = formatTrendsDate(yesterday);
+            const formattedEnd = formatTrendsDate(date);
+            return `${formattedStart} ${formattedEnd}`;
+        };
+        const exploreResponse = await this.explore({
+            keyword: Array.isArray(keyword) ? keyword[0] : keyword,
+            geo: Array.isArray(geo) ? geo[0] : geo,
+            time: `${getDateRangeParam(startTime)} ${getDateRangeParam(endTime)}`,
+            category,
+            hl
+        });
+        const widget = exploreResponse.widgets.find(w => w.id === 'GEO_MAP');
+        if (!widget) {
+            return { default: { geoMapData: [] } };
+        }
+        const options = {
+            ...constants_1.GOOGLE_TRENDS_MAPPER[enums_1.GoogleTrendsEndpoints.interestByRegion],
+            qs: {
+                hl,
+                tz: timezone.toString(),
+                req: JSON.stringify({
+                    geo: {
+                        country: Array.isArray(geo) ? geo[0] : geo
+                    },
+                    comparisonItem: [{
+                            time: `${formatDate(startTime)} ${formatDate(endTime)}`,
+                            complexKeywordsRestriction: {
+                                keyword: [{
+                                        type: 'BROAD', //'ENTITY',
+                                        value: Array.isArray(keyword) ? keyword[0] : keyword
+                                    }]
+                            }
+                        }],
+                    resolution,
+                    locale: hl,
+                    requestOptions: {
+                        property: '',
+                        backend: 'CM', //'IZG',
+                        category
+                    },
+                    userConfig: {
+                        userType: 'USER_TYPE_LEGIT_USER'
+                    }
+                }),
+                token: widget.token
+            }
+        };
+        try {
+            const response = await (0, request_1.request)(options.url, options);
+            const text = await response.text();
+            // Remove the first 5 characters (JSONP wrapper) and parse
+            const data = JSON.parse(text.slice(5));
+            return data;
+        }
+        catch (error) {
+            return { default: { geoMapData: [] } };
+        }
+    }
+    async relatedTopics({ keyword, geo = 'US', time = 'now 1-d', category = 0, property = '', hl = 'en-US', }) {
+        try {
+            // Validate keyword
+            if (!keyword || keyword.trim() === '') {
+                return { error: new GoogleTrendsError_1.ParseError() };
+            }
+            const autocompleteResult = await this.autocomplete(keyword, hl);
+            if (autocompleteResult.error) {
+                return { error: autocompleteResult.error };
+            }
+            const relatedTopics = autocompleteResult.data?.slice(0, 10).map((suggestion, index) => ({
+                topic: {
+                    mid: `/m/${index}`,
+                    title: suggestion,
+                    type: 'Topic'
+                },
+                value: 100 - index * 10,
+                formattedValue: (100 - index * 10).toString(),
+                hasData: true,
+                link: `/trends/explore?q=${encodeURIComponent(suggestion)}&date=${time}&geo=${geo}`
+            })) || [];
+            return {
+                data: {
+                    default: {
+                        rankedList: [{
+                                rankedKeyword: relatedTopics
+                            }]
+                    }
+                }
+            };
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                return { error: new GoogleTrendsError_1.NetworkError(error.message) };
+            }
+            return { error: new GoogleTrendsError_1.UnknownError() };
+        }
+    }
+    async relatedQueries({ keyword, geo = 'US', time = 'now 1-d', category = 0, property = '', hl = 'en-US', }) {
+        try {
+            // Validate keyword
+            if (!keyword || keyword.trim() === '') {
+                return { error: new GoogleTrendsError_1.ParseError() };
+            }
+            const autocompleteResult = await this.autocomplete(keyword, hl);
+            if (autocompleteResult.error) {
+                return { error: autocompleteResult.error };
+            }
+            const relatedQueries = autocompleteResult.data?.slice(0, 10).map((suggestion, index) => ({
+                query: suggestion,
+                value: 100 - index * 10,
+                formattedValue: (100 - index * 10).toString(),
+                hasData: true,
+                link: `/trends/explore?q=${encodeURIComponent(suggestion)}&date=${time}&geo=${geo}`
+            })) || [];
+            return {
+                data: {
+                    default: {
+                        rankedList: [{
+                                rankedKeyword: relatedQueries
+                            }]
+                    }
+                }
+            };
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                return { error: new GoogleTrendsError_1.NetworkError(error.message) };
+            }
+            return { error: new GoogleTrendsError_1.UnknownError() };
+        }
+    }
+    async relatedData({ keyword, geo = 'US', time = 'now 1-d', category = 0, property = '', hl = 'en-US', }) {
+        try {
+            // Validate keyword
+            if (!keyword || keyword.trim() === '') {
+                return { error: new GoogleTrendsError_1.ParseError() };
+            }
+            const autocompleteResult = await this.autocomplete(keyword, hl);
+            if (autocompleteResult.error) {
+                return { error: autocompleteResult.error };
+            }
+            const suggestions = autocompleteResult.data?.slice(0, 10) || [];
+            const topics = suggestions.map((suggestion, index) => ({
+                topic: {
+                    mid: `/m/${index}`,
+                    title: suggestion,
+                    type: 'Topic'
+                },
+                value: 100 - index * 10,
+                formattedValue: (100 - index * 10).toString(),
+                hasData: true,
+                link: `/trends/explore?q=${encodeURIComponent(suggestion)}&date=${time}&geo=${geo}`
+            }));
+            const queries = suggestions.map((suggestion, index) => ({
+                query: suggestion,
+                value: 100 - index * 10,
+                formattedValue: (100 - index * 10).toString(),
+                hasData: true,
+                link: `/trends/explore?q=${encodeURIComponent(suggestion)}&date=${time}&geo=${geo}`
+            }));
+            return {
+                data: {
+                    topics,
+                    queries
+                }
+            };
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                return { error: new GoogleTrendsError_1.NetworkError(error.message) };
+            }
+            return { error: new GoogleTrendsError_1.UnknownError() };
+        }
+    }
+}
+exports.GoogleTrendsApi = GoogleTrendsApi;
+exports.default = new GoogleTrendsApi();

package/{lib → dist/cjs}/helpers/request.d.ts

@@ -3,7 +3,7 @@ export declare const request: (url: string, options: {
     qs?: Record<string, any>;
     body?: string | Record<string, any>;
     headers?: Record<string, string>;
-    contentType?: 'json' | 'form';
+    contentType?: "json" | "form";
 }) => Promise<{
     text: () => Promise<string>;
 }>;

package/{lib → dist/cjs}/helpers/request.js

@@ -1,13 +1,4 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -29,7 +20,7 @@ function rereq(options, body) {
         req.end();
     });
 }
-const request = (url, options) => __awaiter(void 0, void 0, void 0, function* () {
+const request = async (url, options) => {
     const parsedUrl = new URL(url);
     const method = options.method || 'POST';
     // Prepare body
@@ -49,20 +40,25 @@ const request = (url, options) => __awaiter(void 0, void 0, void 0, function* ()
         port: parsedUrl.port || 443,
         path: `${parsedUrl.pathname}${options.qs ? '?' + querystring_1.default.stringify(options.qs) : ''}`,
         method,
-        headers: Object.assign(Object.assign(Object.assign(Object.assign({}, (options.headers || {})), (contentType === 'form'
-            ? { 'Content-Type': 'application/x-www-form-urlencoded' }
-            : { 'Content-Type': 'application/json' })), (bodyString ? { 'Content-Length': Buffer.byteLength(bodyString).toString() } : {})), (cookieVal ? { cookie: cookieVal } : {}))
+        headers: {
+            ...(options.headers || {}),
+            ...(contentType === 'form'
+                ? { 'Content-Type': 'application/x-www-form-urlencoded' }
+                : { 'Content-Type': 'application/json' }),
+            ...(bodyString ? { 'Content-Length': Buffer.byteLength(bodyString).toString() } : {}),
+            ...(cookieVal ? { cookie: cookieVal } : {})
+        }
     };
-    const response = yield new Promise((resolve, reject) => {
+    const response = await new Promise((resolve, reject) => {
         const req = https_1.default.request(requestOptions, (res) => {
             let chunk = '';
             res.on('data', (data) => { chunk += data; });
-            res.on('end', () => __awaiter(void 0, void 0, void 0, function* () {
+            res.on('end', async () => {
                 if (res.statusCode === 429 && res.headers['set-cookie']) {
                     cookieVal = res.headers['set-cookie'][0].split(';')[0];
                     requestOptions.headers['cookie'] = cookieVal;
                     try {
-                        const retryResponse = yield rereq(requestOptions, bodyString);
+                        const retryResponse = await rereq(requestOptions, bodyString);
                         resolve(retryResponse);
                     }
                     catch (err) {
@@ -72,7 +68,7 @@ const request = (url, options) => __awaiter(void 0, void 0, void 0, function* ()
                 else {
                     resolve(chunk);
                 }
-            }));
+            });
         });
         req.on('error', reject);
         if (bodyString)
@@ -82,5 +78,5 @@ const request = (url, options) => __awaiter(void 0, void 0, void 0, function* ()
     return {
         text: () => Promise.resolve(response)
     };
-});
+};
 exports.request = request;

package/dist/cjs/index.d.ts

@@ -0,0 +1,19 @@
+export declare const dailyTrends: ({ geo, lang }: import("./types").DailyTrendingTopicsOptions) => Promise<import("./types").GoogleTrendsResponse<import("./types").DailyTrendingTopics>>;
+export declare const realTimeTrends: ({ geo, trendingHours }: import("./types").RealTimeTrendsOptions) => Promise<import("./types").GoogleTrendsResponse<import("./types").DailyTrendingTopics>>;
+export declare const autocomplete: (keyword: string, hl?: string) => Promise<import("./types").GoogleTrendsResponse<string[]>>;
+export declare const explore: ({ keyword, geo, time, category, property, hl, }: import("./types").ExploreOptions) => Promise<import("./types").ExploreResponse>;
+export declare const interestByRegion: ({ keyword, startTime, endTime, geo, resolution, hl, timezone, category }: import("./types").InterestByRegionOptions) => Promise<import("./types").InterestByRegionResponse>;
+export declare const relatedTopics: ({ keyword, geo, time, category, property, hl, }: import("./types").ExploreOptions) => Promise<import("./types").GoogleTrendsResponse<import("./types").RelatedTopicsResponse>>;
+export declare const relatedQueries: ({ keyword, geo, time, category, property, hl, }: import("./types").ExploreOptions) => Promise<import("./types").GoogleTrendsResponse<import("./types").RelatedQueriesResponse>>;
+export declare const relatedData: ({ keyword, geo, time, category, property, hl, }: import("./types").ExploreOptions) => Promise<import("./types").GoogleTrendsResponse<import("./types").RelatedData>>;
+declare const _default: {
+    dailyTrends: ({ geo, lang }: import("./types").DailyTrendingTopicsOptions) => Promise<import("./types").GoogleTrendsResponse<import("./types").DailyTrendingTopics>>;
+    realTimeTrends: ({ geo, trendingHours }: import("./types").RealTimeTrendsOptions) => Promise<import("./types").GoogleTrendsResponse<import("./types").DailyTrendingTopics>>;
+    autocomplete: (keyword: string, hl?: string) => Promise<import("./types").GoogleTrendsResponse<string[]>>;
+    explore: ({ keyword, geo, time, category, property, hl, }: import("./types").ExploreOptions) => Promise<import("./types").ExploreResponse>;
+    interestByRegion: ({ keyword, startTime, endTime, geo, resolution, hl, timezone, category }: import("./types").InterestByRegionOptions) => Promise<import("./types").InterestByRegionResponse>;
+    relatedTopics: ({ keyword, geo, time, category, property, hl, }: import("./types").ExploreOptions) => Promise<import("./types").GoogleTrendsResponse<import("./types").RelatedTopicsResponse>>;
+    relatedQueries: ({ keyword, geo, time, category, property, hl, }: import("./types").ExploreOptions) => Promise<import("./types").GoogleTrendsResponse<import("./types").RelatedQueriesResponse>>;
+    relatedData: ({ keyword, geo, time, category, property, hl, }: import("./types").ExploreOptions) => Promise<import("./types").GoogleTrendsResponse<import("./types").RelatedData>>;
+};
+export default _default;

package/dist/cjs/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.relatedData = exports.relatedQueries = exports.relatedTopics = exports.interestByRegion = exports.explore = exports.autocomplete = exports.realTimeTrends = exports.dailyTrends = void 0;
+const googleTrendsAPI_1 = require("./helpers/googleTrendsAPI");
+const api = new googleTrendsAPI_1.GoogleTrendsApi();
+exports.dailyTrends = api.dailyTrends.bind(api);
+exports.realTimeTrends = api.realTimeTrends.bind(api);
+exports.autocomplete = api.autocomplete.bind(api);
+exports.explore = api.explore.bind(api);
+exports.interestByRegion = api.interestByRegion.bind(api);
+exports.relatedTopics = api.relatedTopics.bind(api);
+exports.relatedQueries = api.relatedQueries.bind(api);
+exports.relatedData = api.relatedData.bind(api);
+// Default export for CommonJS compatibility
+exports.default = {
+    dailyTrends: exports.dailyTrends,
+    realTimeTrends: exports.realTimeTrends,
+    autocomplete: exports.autocomplete,
+    explore: exports.explore,
+    interestByRegion: exports.interestByRegion,
+    relatedTopics: exports.relatedTopics,
+    relatedQueries: exports.relatedQueries,
+    relatedData: exports.relatedData
+};

package/dist/cjs/types/enums.d.ts

@@ -0,0 +1,14 @@
+export declare enum GoogleTrendsEndpoints {
+    dailyTrends = "dailyTrends",
+    autocomplete = "autocomplete",
+    explore = "explore",
+    interestByRegion = "interestByRegion",
+    relatedTopics = "relatedTopics",
+    relatedQueries = "relatedQueries"
+}
+export declare enum GoogleTrendsTrendingHours {
+    fourHrs = 4,
+    oneDay = 24,
+    twoDays = 48,
+    sevenDays = 168
+}

package/dist/cjs/types/enums.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoogleTrendsTrendingHours = exports.GoogleTrendsEndpoints = void 0;
+var GoogleTrendsEndpoints;
+(function (GoogleTrendsEndpoints) {
+    GoogleTrendsEndpoints["dailyTrends"] = "dailyTrends";
+    GoogleTrendsEndpoints["autocomplete"] = "autocomplete";
+    GoogleTrendsEndpoints["explore"] = "explore";
+    GoogleTrendsEndpoints["interestByRegion"] = "interestByRegion";
+    GoogleTrendsEndpoints["relatedTopics"] = "relatedTopics";
+    GoogleTrendsEndpoints["relatedQueries"] = "relatedQueries";
+})(GoogleTrendsEndpoints || (exports.GoogleTrendsEndpoints = GoogleTrendsEndpoints = {}));
+var GoogleTrendsTrendingHours;
+(function (GoogleTrendsTrendingHours) {
+    GoogleTrendsTrendingHours[GoogleTrendsTrendingHours["fourHrs"] = 4] = "fourHrs";
+    GoogleTrendsTrendingHours[GoogleTrendsTrendingHours["oneDay"] = 24] = "oneDay";
+    GoogleTrendsTrendingHours[GoogleTrendsTrendingHours["twoDays"] = 48] = "twoDays";
+    GoogleTrendsTrendingHours[GoogleTrendsTrendingHours["sevenDays"] = 168] = "sevenDays";
+})(GoogleTrendsTrendingHours || (exports.GoogleTrendsTrendingHours = GoogleTrendsTrendingHours = {}));

package/dist/esm/constants.d.ts

@@ -0,0 +1,3 @@
+import { GoogleTrendsEndpoints } from './types/enums';
+import { GoogleTrendsMapper } from './types';
+export declare const GOOGLE_TRENDS_MAPPER: Record<GoogleTrendsEndpoints, GoogleTrendsMapper>;

package/dist/esm/constants.js

@@ -0,0 +1,50 @@
+import { GoogleTrendsEndpoints } from './types/enums';
+const GOOGLE_TRENDS_BASE_URL = 'trends.google.com';
+export const GOOGLE_TRENDS_MAPPER = {
+    [GoogleTrendsEndpoints.dailyTrends]: {
+        path: '/_/TrendsUi/data/batchexecute',
+        method: 'POST',
+        host: GOOGLE_TRENDS_BASE_URL,
+        url: `https://${GOOGLE_TRENDS_BASE_URL}/_/TrendsUi/data/batchexecute`,
+        headers: {
+            'Content-Type': 'application/x-www-form-urlencoded;charset=UTF-8',
+        },
+    },
+    [GoogleTrendsEndpoints.autocomplete]: {
+        path: '/trends/api/autocomplete',
+        method: 'GET',
+        host: GOOGLE_TRENDS_BASE_URL,
+        url: `https://${GOOGLE_TRENDS_BASE_URL}/trends/api/autocomplete`,
+        headers: {
+            accept: 'application/json, text/plain, */*',
+        },
+    },
+    [GoogleTrendsEndpoints.explore]: {
+        path: '/trends/api/explore',
+        method: 'POST',
+        host: GOOGLE_TRENDS_BASE_URL,
+        url: `https://${GOOGLE_TRENDS_BASE_URL}/trends/api/explore`,
+        headers: {},
+    },
+    [GoogleTrendsEndpoints.interestByRegion]: {
+        path: '/trends/api/widgetdata/comparedgeo',
+        method: 'GET',
+        host: GOOGLE_TRENDS_BASE_URL,
+        url: `https://${GOOGLE_TRENDS_BASE_URL}/trends/api/widgetdata/comparedgeo`,
+        headers: {},
+    },
+    [GoogleTrendsEndpoints.relatedTopics]: {
+        path: '/trends/api/widgetdata/relatedtopics',
+        method: 'GET',
+        host: GOOGLE_TRENDS_BASE_URL,
+        url: `https://${GOOGLE_TRENDS_BASE_URL}/trends/api/widgetdata/relatedtopics`,
+        headers: {},
+    },
+    [GoogleTrendsEndpoints.relatedQueries]: {
+        path: '/trends/api/widgetdata/relatedqueries',
+        method: 'GET',
+        host: GOOGLE_TRENDS_BASE_URL,
+        url: `https://${GOOGLE_TRENDS_BASE_URL}/trends/api/widgetdata/relatedqueries`,
+        headers: {},
+    },
+};

package/dist/esm/errors/GoogleTrendsError.d.ts

@@ -0,0 +1,23 @@
+import { GoogleTrendsError } from '../types';
+export declare class RateLimitError extends Error implements GoogleTrendsError {
+    code: string;
+    statusCode: number;
+    constructor(message?: string);
+}
+export declare class InvalidRequestError extends Error implements GoogleTrendsError {
+    code: string;
+    statusCode: number;
+    constructor(message?: string);
+}
+export declare class NetworkError extends Error implements GoogleTrendsError {
+    code: string;
+    constructor(message?: string);
+}
+export declare class ParseError extends Error implements GoogleTrendsError {
+    code: string;
+    constructor(message?: string);
+}
+export declare class UnknownError extends Error implements GoogleTrendsError {
+    code: string;
+    constructor(message?: string);
+}

package/dist/esm/errors/GoogleTrendsError.js

@@ -0,0 +1,37 @@
+export class RateLimitError extends Error {
+    constructor(message = 'Rate limit exceeded') {
+        super(message);
+        this.code = 'RATE_LIMIT_EXCEEDED';
+        this.statusCode = 429;
+        this.name = 'RateLimitError';
+    }
+}
+export class InvalidRequestError extends Error {
+    constructor(message = 'Invalid request parameters') {
+        super(message);
+        this.code = 'INVALID_REQUEST';
+        this.statusCode = 400;
+        this.name = 'InvalidRequestError';
+    }
+}
+export class NetworkError extends Error {
+    constructor(message = 'Network request failed') {
+        super(message);
+        this.code = 'NETWORK_ERROR';
+        this.name = 'NetworkError';
+    }
+}
+export class ParseError extends Error {
+    constructor(message = 'Failed to parse response') {
+        super(message);
+        this.code = 'PARSE_ERROR';
+        this.name = 'ParseError';
+    }
+}
+export class UnknownError extends Error {
+    constructor(message = 'An unknown error occurred') {
+        super(message);
+        this.code = 'UNKNOWN_ERROR';
+        this.name = 'UnknownError';
+    }
+}

package/dist/esm/helpers/format.d.ts

@@ -0,0 +1,2 @@
+import { DailyTrendingTopics } from '../types';
+export declare const extractJsonFromResponse: (text: string) => DailyTrendingTopics | null;