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

package/README.md

@@ -17,6 +17,9 @@ npm install @shaivpidadi/trends-js
 - Get autocomplete suggestions
 - Explore trends data
 - Get interest by region data
+- Get related topics for any keyword
+- Get related queries for any keyword
+- Get combined related data (topics + queries)
 - TypeScript support
 - Promise-based API
 
@@ -33,9 +36,9 @@ import GoogleTrendsApi from '@shaivpidadi/trends-js';
 Get daily trending topics for a specific region:
 
 ```typescript
-const result = await GoogleTrendsApi.dailyTrends({ 
-  geo: 'US',  // Default: 'US'
-  lang: 'en'  // Default: 'en'
+const result = await GoogleTrendsApi.dailyTrends({
+  geo: 'US', // Default: 'US'
+  lang: 'en', // Default: 'en'
 });
 
 // Result structure:
@@ -50,9 +53,9 @@ const result = await GoogleTrendsApi.dailyTrends({
 Get real-time trending topics:
 
 ```typescript
-const result = await GoogleTrendsApi.realTimeTrends({ 
-  geo: 'US',           // Default: 'US'
-  trendingHours: 4     // Default: 4
+const result = await GoogleTrendsApi.realTimeTrends({
+  geo: 'US', // Default: 'US'
+  trendingHours: 4, // Default: 4
 });
 
 // Result structure:
@@ -68,8 +71,8 @@ Get search suggestions for a keyword:
 
 ```typescript
 const suggestions = await GoogleTrendsApi.autocomplete(
-  'bitcoin',           // Keyword to get suggestions for
-  'en-US'              // Language (default: 'en-US')
+  'bitcoin', // Keyword to get suggestions for
+  'en-US', // Language (default: 'en-US')
 );
 
 // Returns: string[]
@@ -80,13 +83,13 @@ const suggestions = await GoogleTrendsApi.autocomplete(
 Get widget data for a keyword:
 
 ```typescript
-const result = await GoogleTrendsApi.explore({ 
+const result = await GoogleTrendsApi.explore({
   keyword: 'bitcoin',
-  geo: 'US',           // Default: 'US'
-  time: 'today 12-m',  // Default: 'today 12-m'
-  category: 0,         // Default: 0
-  property: '',        // Default: ''
-  hl: 'en-US'         // Default: 'en-US'
+  geo: 'US', // Default: 'US'
+  time: 'today 12-m', // Default: 'today 12-m'
+  category: 0, // Default: 0
+  property: '', // Default: ''
+  hl: 'en-US', // Default: 'en-US'
 });
 
 // Result structure:
@@ -104,15 +107,15 @@ const result = await GoogleTrendsApi.explore({
 Get interest data by region:
 
 ```typescript
-const result = await GoogleTrendsApi.interestByRegion({ 
-  keyword: 'Stock Market',           // Required - string or string[]
+const result = await GoogleTrendsApi.interestByRegion({
+  keyword: 'Stock Market', // Required - string or string[]
   startTime: new Date('2024-01-01'), // Optional - defaults to 2004-01-01
-  endTime: new Date(),               // Optional - defaults to current date
-  geo: 'US',                         // Optional - string or string[] - defaults to 'US'
-  resolution: 'REGION',              // Optional - 'COUNTRY' | 'REGION' | 'CITY' | 'DMA'
-  hl: 'en-US',                      // Optional - defaults to 'en-US'
-  timezone: -240,                   // Optional - defaults to local timezone
-  category: 0                       // Optional - defaults to 0
+  endTime: new Date(), // Optional - defaults to current date
+  geo: 'US', // Optional - string or string[] - defaults to 'US'
+  resolution: 'REGION', // Optional - 'COUNTRY' | 'REGION' | 'CITY' | 'DMA'
+  hl: 'en-US', // Optional - defaults to 'en-US'
+  timezone: -240, // Optional - defaults to local timezone
+  category: 0, // Optional - defaults to 0
 });
 
 // Result structure:
@@ -137,22 +140,113 @@ const result = await GoogleTrendsApi.interestByRegion({
 Example with multiple keywords and regions:
 
 ```typescript
-const result = await GoogleTrendsApi.interestByRegion({ 
+const result = await GoogleTrendsApi.interestByRegion({
   keyword: ['wine', 'peanuts'],
   geo: ['US-CA', 'US-VA'],
   startTime: new Date('2024-01-01'),
   endTime: new Date(),
-  resolution: 'CITY'
+  resolution: 'CITY',
 });
 ```
 
+### Related Topics
+
+Get related topics for any keyword:
+
+```typescript
+const result = await GoogleTrendsApi.relatedTopics({
+  keyword: 'artificial intelligence', // Required
+  geo: 'US', // Optional - defaults to 'US'
+  time: 'now 1-d', // Optional - defaults to 'now 1-d'
+  category: 0, // Optional - defaults to 0
+  property: '', // Optional - defaults to ''
+  hl: 'en-US', // Optional - defaults to 'en-US'
+});
+
+// Result structure:
+// {
+//   data: {
+//     default: {
+//       rankedList: Array<{
+//         rankedKeyword: Array<{
+//           topic: {
+//             mid: string,
+//             title: string,
+//             type: string
+//           },
+//           value: number,
+//           formattedValue: string,
+//           hasData: boolean,
+//           link: string
+//         }>
+//       }>
+//     }
+//   }
+// }
+```
+
+### Related Queries
+
+Get related queries for any keyword:
+
+```typescript
+const result = await GoogleTrendsApi.relatedQueries({
+  keyword: 'machine learning', // Required
+  geo: 'US', // Optional - defaults to 'US'
+  time: 'now 1-d', // Optional - defaults to 'now 1-d'
+  category: 0, // Optional - defaults to 0
+  property: '', // Optional - defaults to ''
+  hl: 'en-US', // Optional - defaults to 'en-US'
+});
+
+// Result structure:
+// {
+//   data: {
+//     default: {
+//       rankedList: Array<{
+//         rankedKeyword: Array<{
+//           query: string,
+//           value: number,
+//           formattedValue: string,
+//           hasData: boolean,
+//           link: string
+//         }>
+//       }>
+//     }
+//   }
+// }
+```
+
+### Combined Related Data
+
+Get both related topics and queries in a single call:
+
+```typescript
+const result = await GoogleTrendsApi.relatedData({
+  keyword: 'blockchain', // Required
+  geo: 'US', // Optional - defaults to 'US'
+  time: 'now 1-d', // Optional - defaults to 'now 1-d'
+  category: 0, // Optional - defaults to 0
+  property: '', // Optional - defaults to ''
+  hl: 'en-US', // Optional - defaults to 'en-US'
+});
+
+// Result structure:
+// {
+//   data: {
+//     topics: Array<RelatedTopic>,
+//     queries: Array<RelatedQuery>
+//   }
+// }
+```
+
 ## API Reference
 
 ### DailyTrendsOptions
 
 ```typescript
 interface DailyTrendsOptions {
-  geo?: string;  // Default: 'US'
+  geo?: string; // Default: 'US'
   lang?: string; // Default: 'en'
 }
 ```
@@ -171,11 +265,11 @@ interface RealTimeTrendsOptions {
 ```typescript
 interface ExploreOptions {
   keyword: string;
-  geo?: string;           // Default: 'US'
-  time?: string;          // Default: 'today 12-m'
-  category?: number;      // Default: 0
-  property?: string;      // Default: ''
-  hl?: string;           // Default: 'en-US'
+  geo?: string; // Default: 'US'
+  time?: string; // Default: 'today 12-m'
+  category?: number; // Default: 0
+  property?: string; // Default: ''
+  hl?: string; // Default: 'en-US'
 }
 ```
 
@@ -183,14 +277,63 @@ interface ExploreOptions {
 
 ```typescript
 interface InterestByRegionOptions {
-  keyword: string | string[];        // Required - search term(s)
-  startTime?: Date;                  // Optional - start date
-  endTime?: Date;                    // Optional - end date
-  geo?: string | string[];           // Optional - geocode(s)
+  keyword: string | string[]; // Required - search term(s)
+  startTime?: Date; // Optional - start date
+  endTime?: Date; // Optional - end date
+  geo?: string | string[]; // Optional - geocode(s)
   resolution?: 'COUNTRY' | 'REGION' | 'CITY' | 'DMA'; // Optional
-  hl?: string;                       // Optional - language code
-  timezone?: number;                 // Optional - timezone offset
-  category?: number;                 // Optional - category number
+  hl?: string; // Optional - language code
+  timezone?: number; // Optional - timezone offset
+  category?: number; // Optional - category number
+}
+```
+
+### RelatedTopicsResponse
+
+```typescript
+interface RelatedTopicsResponse {
+  default: {
+    rankedList: Array<{
+      rankedKeyword: Array<{
+        topic: {
+          mid: string;
+          title: string;
+          type: string;
+        };
+        value: number;
+        formattedValue: string;
+        hasData: boolean;
+        link: string;
+      }>;
+    }>;
+  };
+}
+```
+
+### RelatedQueriesResponse
+
+```typescript
+interface RelatedQueriesResponse {
+  default: {
+    rankedList: Array<{
+      rankedKeyword: Array<{
+        query: string;
+        value: number;
+        formattedValue: string;
+        hasData: boolean;
+        link: string;
+      }>;
+    }>;
+  };
+}
+```
+
+### RelatedData
+
+```typescript
+interface RelatedData {
+  topics: Array<RelatedTopic>;
+  queries: Array<RelatedQuery>;
 }
 ```
 
@@ -198,4 +341,6 @@ interface InterestByRegionOptions {
 
 ### Building
 
-```
+```
+
+```

package/dist/cjs/constants.js

@@ -36,4 +36,18 @@ exports.GOOGLE_TRENDS_MAPPER = {
         url: `https://${GOOGLE_TRENDS_BASE_URL}/trends/api/widgetdata/comparedgeo`,
         headers: {},
     },
+    [enums_1.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: {},
+    },
+    [enums_1.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/cjs/helpers/googleTrendsAPI.d.ts

@@ -1,4 +1,4 @@
-import { DailyTrendingTopics, DailyTrendingTopicsOptions, RealTimeTrendsOptions, ExploreOptions, ExploreResponse, InterestByRegionOptions, InterestByRegionResponse, GoogleTrendsResponse } from '../types/index';
+import { DailyTrendingTopics, DailyTrendingTopicsOptions, RealTimeTrendsOptions, ExploreOptions, ExploreResponse, InterestByRegionOptions, InterestByRegionResponse, GoogleTrendsResponse, RelatedTopicsResponse, RelatedQueriesResponse, RelatedData } from '../types/index';
 export declare class GoogleTrendsApi {
     /**
      * Get autocomplete suggestions for a keyword
@@ -21,6 +21,9 @@ export declare class GoogleTrendsApi {
     realTimeTrends({ geo, trendingHours }: RealTimeTrendsOptions): Promise<GoogleTrendsResponse<DailyTrendingTopics>>;
     explore({ keyword, geo, time, category, property, hl, }: ExploreOptions): Promise<ExploreResponse>;
     interestByRegion({ keyword, startTime, endTime, geo, resolution, hl, timezone, category }: InterestByRegionOptions): Promise<InterestByRegionResponse>;
+    relatedTopics({ keyword, geo, time, category, property, hl, }: ExploreOptions): Promise<GoogleTrendsResponse<RelatedTopicsResponse>>;
+    relatedQueries({ keyword, geo, time, category, property, hl, }: ExploreOptions): Promise<GoogleTrendsResponse<RelatedQueriesResponse>>;
+    relatedData({ keyword, geo, time, category, property, hl, }: ExploreOptions): Promise<GoogleTrendsResponse<RelatedData>>;
 }
 declare const _default: GoogleTrendsApi;
 export default _default;

package/dist/cjs/helpers/googleTrendsAPI.js

@@ -121,9 +121,22 @@ class GoogleTrendsApi {
         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;
+            // 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);
@@ -176,7 +189,7 @@ class GoogleTrendsApi {
                             time: `${formatDate(startTime)} ${formatDate(endTime)}`,
                             complexKeywordsRestriction: {
                                 keyword: [{
-                                        type: 'BROAD',
+                                        type: 'BROAD', //'ENTITY',
                                         value: Array.isArray(keyword) ? keyword[0] : keyword
                                     }]
                             }
@@ -185,7 +198,7 @@ class GoogleTrendsApi {
                     locale: hl,
                     requestOptions: {
                         property: '',
-                        backend: 'CM',
+                        backend: 'CM', //'IZG',
                         category
                     },
                     userConfig: {
@@ -206,6 +219,121 @@ class GoogleTrendsApi {
             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/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/dist/cjs/index.d.ts

@@ -1,9 +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

@@ -1,14 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.autocomplete = exports.realTimeTrends = exports.dailyTrends = void 0;
+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
+    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

@@ -2,7 +2,9 @@ export declare enum GoogleTrendsEndpoints {
     dailyTrends = "dailyTrends",
     autocomplete = "autocomplete",
     explore = "explore",
-    interestByRegion = "interestByRegion"
+    interestByRegion = "interestByRegion",
+    relatedTopics = "relatedTopics",
+    relatedQueries = "relatedQueries"
 }
 export declare enum GoogleTrendsTrendingHours {
     fourHrs = 4,

package/dist/cjs/types/enums.js

@@ -7,11 +7,13 @@ var GoogleTrendsEndpoints;
     GoogleTrendsEndpoints["autocomplete"] = "autocomplete";
     GoogleTrendsEndpoints["explore"] = "explore";
     GoogleTrendsEndpoints["interestByRegion"] = "interestByRegion";
-})(GoogleTrendsEndpoints = exports.GoogleTrendsEndpoints || (exports.GoogleTrendsEndpoints = {}));
+    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 || (exports.GoogleTrendsTrendingHours = {}));
+})(GoogleTrendsTrendingHours || (exports.GoogleTrendsTrendingHours = GoogleTrendsTrendingHours = {}));

package/dist/esm/constants.js

@@ -33,4 +33,18 @@ export const GOOGLE_TRENDS_MAPPER = {
         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/helpers/googleTrendsAPI.d.ts

@@ -1,4 +1,4 @@
-import { DailyTrendingTopics, DailyTrendingTopicsOptions, RealTimeTrendsOptions, ExploreOptions, ExploreResponse, InterestByRegionOptions, InterestByRegionResponse, GoogleTrendsResponse } from '../types/index';
+import { DailyTrendingTopics, DailyTrendingTopicsOptions, RealTimeTrendsOptions, ExploreOptions, ExploreResponse, InterestByRegionOptions, InterestByRegionResponse, GoogleTrendsResponse, RelatedTopicsResponse, RelatedQueriesResponse, RelatedData } from '../types/index';
 export declare class GoogleTrendsApi {
     /**
      * Get autocomplete suggestions for a keyword
@@ -21,6 +21,9 @@ export declare class GoogleTrendsApi {
     realTimeTrends({ geo, trendingHours }: RealTimeTrendsOptions): Promise<GoogleTrendsResponse<DailyTrendingTopics>>;
     explore({ keyword, geo, time, category, property, hl, }: ExploreOptions): Promise<ExploreResponse>;
     interestByRegion({ keyword, startTime, endTime, geo, resolution, hl, timezone, category }: InterestByRegionOptions): Promise<InterestByRegionResponse>;
+    relatedTopics({ keyword, geo, time, category, property, hl, }: ExploreOptions): Promise<GoogleTrendsResponse<RelatedTopicsResponse>>;
+    relatedQueries({ keyword, geo, time, category, property, hl, }: ExploreOptions): Promise<GoogleTrendsResponse<RelatedQueriesResponse>>;
+    relatedData({ keyword, geo, time, category, property, hl, }: ExploreOptions): Promise<GoogleTrendsResponse<RelatedData>>;
 }
 declare const _default: GoogleTrendsApi;
 export default _default;

package/dist/esm/helpers/googleTrendsAPI.js

@@ -118,9 +118,22 @@ export class GoogleTrendsApi {
         try {
             const response = await 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;
+            // 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);
@@ -173,7 +186,7 @@ export class GoogleTrendsApi {
                             time: `${formatDate(startTime)} ${formatDate(endTime)}`,
                             complexKeywordsRestriction: {
                                 keyword: [{
-                                        type: 'BROAD',
+                                        type: 'BROAD', //'ENTITY',
                                         value: Array.isArray(keyword) ? keyword[0] : keyword
                                     }]
                             }
@@ -182,7 +195,7 @@ export class GoogleTrendsApi {
                     locale: hl,
                     requestOptions: {
                         property: '',
-                        backend: 'CM',
+                        backend: 'CM', //'IZG',
                         category
                     },
                     userConfig: {
@@ -203,5 +216,120 @@ export class GoogleTrendsApi {
             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 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 NetworkError(error.message) };
+            }
+            return { error: new 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 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 NetworkError(error.message) };
+            }
+            return { error: new 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 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 NetworkError(error.message) };
+            }
+            return { error: new UnknownError() };
+        }
+    }
 }
 export default new GoogleTrendsApi();

package/dist/esm/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/dist/esm/index.d.ts

@@ -1,9 +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/esm/index.js

@@ -3,9 +3,19 @@ const api = new GoogleTrendsApi();
 export const dailyTrends = api.dailyTrends.bind(api);
 export const realTimeTrends = api.realTimeTrends.bind(api);
 export const autocomplete = api.autocomplete.bind(api);
+export const explore = api.explore.bind(api);
+export const interestByRegion = api.interestByRegion.bind(api);
+export const relatedTopics = api.relatedTopics.bind(api);
+export const relatedQueries = api.relatedQueries.bind(api);
+export const relatedData = api.relatedData.bind(api);
 // Default export for CommonJS compatibility
 export default {
     dailyTrends,
     realTimeTrends,
-    autocomplete
+    autocomplete,
+    explore,
+    interestByRegion,
+    relatedTopics,
+    relatedQueries,
+    relatedData
 };

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

@@ -2,7 +2,9 @@ export declare enum GoogleTrendsEndpoints {
     dailyTrends = "dailyTrends",
     autocomplete = "autocomplete",
     explore = "explore",
-    interestByRegion = "interestByRegion"
+    interestByRegion = "interestByRegion",
+    relatedTopics = "relatedTopics",
+    relatedQueries = "relatedQueries"
 }
 export declare enum GoogleTrendsTrendingHours {
     fourHrs = 4,

package/dist/esm/types/enums.js

@@ -4,6 +4,8 @@ export var GoogleTrendsEndpoints;
     GoogleTrendsEndpoints["autocomplete"] = "autocomplete";
     GoogleTrendsEndpoints["explore"] = "explore";
     GoogleTrendsEndpoints["interestByRegion"] = "interestByRegion";
+    GoogleTrendsEndpoints["relatedTopics"] = "relatedTopics";
+    GoogleTrendsEndpoints["relatedQueries"] = "relatedQueries";
 })(GoogleTrendsEndpoints || (GoogleTrendsEndpoints = {}));
 export var GoogleTrendsTrendingHours;
 (function (GoogleTrendsTrendingHours) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shaivpidadi/trends-js",
-  "version": "0.0.0-beta.7",
+  "version": "0.0.0-beta.8",
   "description": "Google Trends API for Node.js",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -40,4 +40,4 @@
     "ts-jest": "^29.1.0",
     "typescript": "^5.0.0"
   }
-}
+}