@shaivpidadi/trends-js 0.0.0-beta.6 → 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.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/{lib → dist/cjs}/constants.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GOOGLE_TRENDS_MAPPER = void 0;
+const enums_1 = require("./types/enums");
 const GOOGLE_TRENDS_BASE_URL = 'trends.google.com';
 exports.GOOGLE_TRENDS_MAPPER = {
-    ["dailyTrends" /* GoogleTrendsEndpoints.dailyTrends */]: {
+    [enums_1.GoogleTrendsEndpoints.dailyTrends]: {
         path: '/_/TrendsUi/data/batchexecute',
         method: 'POST',
         host: GOOGLE_TRENDS_BASE_URL,
@@ -12,7 +13,7 @@ exports.GOOGLE_TRENDS_MAPPER = {
             'Content-Type': 'application/x-www-form-urlencoded;charset=UTF-8',
         },
     },
-    ["autocomplete" /* GoogleTrendsEndpoints.autocomplete */]: {
+    [enums_1.GoogleTrendsEndpoints.autocomplete]: {
         path: '/trends/api/autocomplete',
         method: 'GET',
         host: GOOGLE_TRENDS_BASE_URL,
@@ -21,18 +22,32 @@ exports.GOOGLE_TRENDS_MAPPER = {
             accept: 'application/json, text/plain, */*',
         },
     },
-    ["explore" /* GoogleTrendsEndpoints.explore */]: {
+    [enums_1.GoogleTrendsEndpoints.explore]: {
         path: '/trends/api/explore',
         method: 'POST',
         host: GOOGLE_TRENDS_BASE_URL,
         url: `https://${GOOGLE_TRENDS_BASE_URL}/trends/api/explore`,
         headers: {},
     },
-    ["interestByRegion" /* GoogleTrendsEndpoints.interestByRegion */]: {
+    [enums_1.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: {},
     },
+    [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/{lib → 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;