@gojinko/api-client 2.19.1 → 2.21.0

package/dist/types/generated.d.ts

@@ -16,9 +16,7 @@ export interface paths {
          */
         get: {
             parameters: {
-                query: {
-                    /** @description Analysis mode. `trend` is accepted but currently returns snapshot-shaped data. */
-                    analysis: components["parameters"]["analysis"];
+                query?: {
                     /** @description Origin market filter as <Level>:<Code>, e.g. Country:US or City:NYC. */
                     origin_market?: components["parameters"]["originMarket"];
                     /** @description Optional destination filter as <Level>:<Code>, e.g. Country:TH. */
@@ -41,10 +39,8 @@ export interface paths {
                     search_window_min?: components["parameters"]["searchWindowMin"];
                     /** @description Maximum advance-purchase window in days (must be >= search_window_min). */
                     search_window_max?: components["parameters"]["searchWindowMax"];
-                    /** @description Snapshot mode only: number of most-recent days of search activity aggregated into the demand level (min 2, default 7, max 90 — a 1-day window is the current day, whose data is incomplete; the cube retains 90 days). Rejected when analysis=trend. */
+                    /** @description Number of most-recent days of search activity aggregated into the demand level (min 2, default 7, max 90 — a 1-day window is the current day, whose data is incomplete; the cube retains 90 days). */
                     snapshot_window_days?: components["parameters"]["snapshotWindowDays"];
-                    /** @description Trend mode only: size in days of each of the two adjacent windows compared for growth (min 2, default 7, max 45 — a 1-day window's recent period is the current day, whose data is incomplete; a trend spans 2x the window within the cube's 90-day retention). Rejected when analysis=snapshot. */
-                    trend_window_days?: components["parameters"]["trendWindowDays"];
                     /** @description Max rows (1-200, default 20). */
                     limit?: components["parameters"]["limit"];
                 };
@@ -105,8 +101,6 @@ export interface paths {
         get: {
             parameters: {
                 query: {
-                    /** @description Analysis mode. `trend` is accepted but currently returns snapshot-shaped data. */
-                    analysis: components["parameters"]["analysis"];
                     /** @description Destination as <Level>:<Code>, e.g. Country:TH. Required for this endpoint. */
                     destination: components["parameters"]["destinationRequired"];
                     /** @description Origin market filter as <Level>:<Code>, e.g. Country:US or City:NYC. */
@@ -129,10 +123,8 @@ export interface paths {
                     search_window_min?: components["parameters"]["searchWindowMin"];
                     /** @description Maximum advance-purchase window in days (must be >= search_window_min). */
                     search_window_max?: components["parameters"]["searchWindowMax"];
-                    /** @description Snapshot mode only: number of most-recent days of search activity aggregated into the demand level (min 2, default 7, max 90 — a 1-day window is the current day, whose data is incomplete; the cube retains 90 days). Rejected when analysis=trend. */
+                    /** @description Number of most-recent days of search activity aggregated into the demand level (min 2, default 7, max 90 — a 1-day window is the current day, whose data is incomplete; the cube retains 90 days). */
                     snapshot_window_days?: components["parameters"]["snapshotWindowDays"];
-                    /** @description Trend mode only: size in days of each of the two adjacent windows compared for growth (min 2, default 7, max 45 — a 1-day window's recent period is the current day, whose data is incomplete; a trend spans 2x the window within the cube's 90-day retention). Rejected when analysis=snapshot. */
-                    trend_window_days?: components["parameters"]["trendWindowDays"];
                     /** @description Max rows (1-200, default 20). */
                     limit?: components["parameters"]["limit"];
                 };
@@ -193,8 +185,6 @@ export interface paths {
         get: {
             parameters: {
                 query: {
-                    /** @description Analysis mode. `trend` is accepted but currently returns snapshot-shaped data. */
-                    analysis: components["parameters"]["analysis"];
                     /** @description Destination as <Level>:<Code>, e.g. Country:TH. Required for this endpoint. */
                     destination: components["parameters"]["destinationRequired"];
                     /** @description Origin market filter as <Level>:<Code>, e.g. Country:US or City:NYC. */
@@ -215,10 +205,8 @@ export interface paths {
                     search_window_min?: components["parameters"]["searchWindowMin"];
                     /** @description Maximum advance-purchase window in days (must be >= search_window_min). */
                     search_window_max?: components["parameters"]["searchWindowMax"];
-                    /** @description Snapshot mode only: number of most-recent days of search activity aggregated into the demand level (min 2, default 7, max 90 — a 1-day window is the current day, whose data is incomplete; the cube retains 90 days). Rejected when analysis=trend. */
+                    /** @description Number of most-recent days of search activity aggregated into the demand level (min 2, default 7, max 90 — a 1-day window is the current day, whose data is incomplete; the cube retains 90 days). */
                     snapshot_window_days?: components["parameters"]["snapshotWindowDays"];
-                    /** @description Trend mode only: size in days of each of the two adjacent windows compared for growth (min 2, default 7, max 45 — a 1-day window's recent period is the current day, whose data is incomplete; a trend spans 2x the window within the cube's 90-day retention). Rejected when analysis=snapshot. */
-                    trend_window_days?: components["parameters"]["trendWindowDays"];
                     /** @description Max rows (1-200, default 20). */
                     limit?: components["parameters"]["limit"];
                 };
@@ -265,6 +253,346 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/trend": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Demand time series for explicit origin/destination pairs
+         * @description Deep dive: returns one de-sampled search-volume series per (origin, destination) pair. v1 allows a list on only one side — a single origin with many destinations, or many origins with a single destination.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description Pairs endpoint: comma-separated origin selectors `<Level>:<Code>` (e.g. `Country:US,Country:CA`). v1: at most one of origins/destinations may have more than one entry. */
+                    origins: components["parameters"]["origins"];
+                    /** @description Pairs endpoint: comma-separated destination selectors `<Level>:<Code>` (e.g. `Country:FR,Country:DE`). */
+                    destinations: components["parameters"]["destinations"];
+                    /** @description Named departure window (defaults to Next90Days server-side). */
+                    travel_period?: components["parameters"]["travelPeriod"];
+                    /** @description Start of departure window (YYYY-MM-DD). Required when travel_period=Custom. */
+                    departure_date_from?: components["parameters"]["departureDateFrom"];
+                    /** @description End of departure window (YYYY-MM-DD). Required when travel_period=Custom. */
+                    departure_date_to?: components["parameters"]["departureDateTo"];
+                    /** @description Optional traveler-type filter. */
+                    traveler_type?: components["parameters"]["travelerType"];
+                    /** @description Optional trip-type filter. */
+                    trip_type?: components["parameters"]["tripType"];
+                    /** @description Minimum trip length in nights (return_date − dep_date). Round-trips only; must be >= 0. */
+                    trip_duration_min?: components["parameters"]["tripDurationMin"];
+                    /** @description Maximum trip length in nights (must be >= trip_duration_min). */
+                    trip_duration_max?: components["parameters"]["tripDurationMax"];
+                    /** @description Minimum advance-purchase window in days (dep_date − search_date): searches made at least this many days before departure. Must be >= 0. */
+                    search_window_min?: components["parameters"]["searchWindowMin"];
+                    /** @description Maximum advance-purchase window in days (must be >= search_window_min). */
+                    search_window_max?: components["parameters"]["searchWindowMax"];
+                    /** @description Number of buckets N in the chosen granularity's own unit (min 2; max depends on granularity: day <= 60, week <= 52, month <= 12; default 12 applied server-side). The series spans the last N complete buckets, excluding the in-progress one. */
+                    trend_window?: components["parameters"]["trendWindow"];
+                    /** @description Bucket size for the returned series: week (default), day, or month. */
+                    granularity?: components["parameters"]["granularity"];
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Per-pair demand time series */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["TrendResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Validation error */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/destination/trend": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Demand time series for the top-N destinations
+         * @description Ranks destinations (optionally reachable from origin_market) by within-window growth, then returns each top-N destination's series.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Origin market filter as <Level>:<Code>, e.g. Country:US or City:NYC. */
+                    origin_market?: components["parameters"]["originMarket"];
+                    /** @description Optional destination filter as <Level>:<Code>, e.g. Country:TH. */
+                    destination?: components["parameters"]["destinationFilter"];
+                    /** @description Named departure window (defaults to Next90Days server-side). */
+                    travel_period?: components["parameters"]["travelPeriod"];
+                    /** @description Start of departure window (YYYY-MM-DD). Required when travel_period=Custom. */
+                    departure_date_from?: components["parameters"]["departureDateFrom"];
+                    /** @description End of departure window (YYYY-MM-DD). Required when travel_period=Custom. */
+                    departure_date_to?: components["parameters"]["departureDateTo"];
+                    /** @description Optional traveler-type filter. */
+                    traveler_type?: components["parameters"]["travelerType"];
+                    /** @description Optional trip-type filter. */
+                    trip_type?: components["parameters"]["tripType"];
+                    /** @description Minimum trip length in nights (return_date − dep_date). Round-trips only; must be >= 0. */
+                    trip_duration_min?: components["parameters"]["tripDurationMin"];
+                    /** @description Maximum trip length in nights (must be >= trip_duration_min). */
+                    trip_duration_max?: components["parameters"]["tripDurationMax"];
+                    /** @description Minimum advance-purchase window in days (dep_date − search_date): searches made at least this many days before departure. Must be >= 0. */
+                    search_window_min?: components["parameters"]["searchWindowMin"];
+                    /** @description Maximum advance-purchase window in days (must be >= search_window_min). */
+                    search_window_max?: components["parameters"]["searchWindowMax"];
+                    /** @description Number of buckets N in the chosen granularity's own unit (min 2; max depends on granularity: day <= 60, week <= 52, month <= 12; default 12 applied server-side). The series spans the last N complete buckets, excluding the in-progress one. */
+                    trend_window?: components["parameters"]["trendWindow"];
+                    /** @description Bucket size for the returned series: week (default), day, or month. */
+                    granularity?: components["parameters"]["granularity"];
+                    /** @description Trend endpoints: maximum number of series (top-N keys). Default 10, max 50. */
+                    limit?: components["parameters"]["trendLimit"];
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Top-N destination time series */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["TrendResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Validation error */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/market/trend": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Demand time series for the top-N source markets
+         * @description Ranks source markets for a destination by within-window growth, then returns each top-N market's series. `destination` is required.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description Destination as <Level>:<Code>, e.g. Country:TH. Required for this endpoint. */
+                    destination: components["parameters"]["destinationRequired"];
+                    /** @description Origin market filter as <Level>:<Code>, e.g. Country:US or City:NYC. */
+                    origin_market?: components["parameters"]["originMarket"];
+                    /** @description Named departure window (defaults to Next90Days server-side). */
+                    travel_period?: components["parameters"]["travelPeriod"];
+                    /** @description Start of departure window (YYYY-MM-DD). Required when travel_period=Custom. */
+                    departure_date_from?: components["parameters"]["departureDateFrom"];
+                    /** @description End of departure window (YYYY-MM-DD). Required when travel_period=Custom. */
+                    departure_date_to?: components["parameters"]["departureDateTo"];
+                    /** @description Optional traveler-type filter. */
+                    traveler_type?: components["parameters"]["travelerType"];
+                    /** @description Optional trip-type filter. */
+                    trip_type?: components["parameters"]["tripType"];
+                    /** @description Minimum trip length in nights (return_date − dep_date). Round-trips only; must be >= 0. */
+                    trip_duration_min?: components["parameters"]["tripDurationMin"];
+                    /** @description Maximum trip length in nights (must be >= trip_duration_min). */
+                    trip_duration_max?: components["parameters"]["tripDurationMax"];
+                    /** @description Minimum advance-purchase window in days (dep_date − search_date): searches made at least this many days before departure. Must be >= 0. */
+                    search_window_min?: components["parameters"]["searchWindowMin"];
+                    /** @description Maximum advance-purchase window in days (must be >= search_window_min). */
+                    search_window_max?: components["parameters"]["searchWindowMax"];
+                    /** @description Number of buckets N in the chosen granularity's own unit (min 2; max depends on granularity: day <= 60, week <= 52, month <= 12; default 12 applied server-side). The series spans the last N complete buckets, excluding the in-progress one. */
+                    trend_window?: components["parameters"]["trendWindow"];
+                    /** @description Bucket size for the returned series: week (default), day, or month. */
+                    granularity?: components["parameters"]["granularity"];
+                    /** @description Trend endpoints: maximum number of series (top-N keys). Default 10, max 50. */
+                    limit?: components["parameters"]["trendLimit"];
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Top-N market time series */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["TrendResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Validation error */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/audience/trend": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Demand time series for the traveler-type mix
+         * @description Returns a series per traveler-type segment (Solo / Couple / Family / Group) of demand for a destination. `destination` is required; `traveler_type` is not a filter here — this endpoint buckets by it.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description Destination as <Level>:<Code>, e.g. Country:TH. Required for this endpoint. */
+                    destination: components["parameters"]["destinationRequired"];
+                    /** @description Origin market filter as <Level>:<Code>, e.g. Country:US or City:NYC. */
+                    origin_market?: components["parameters"]["originMarket"];
+                    /** @description Named departure window (defaults to Next90Days server-side). */
+                    travel_period?: components["parameters"]["travelPeriod"];
+                    /** @description Start of departure window (YYYY-MM-DD). Required when travel_period=Custom. */
+                    departure_date_from?: components["parameters"]["departureDateFrom"];
+                    /** @description End of departure window (YYYY-MM-DD). Required when travel_period=Custom. */
+                    departure_date_to?: components["parameters"]["departureDateTo"];
+                    /** @description Optional trip-type filter. */
+                    trip_type?: components["parameters"]["tripType"];
+                    /** @description Minimum trip length in nights (return_date − dep_date). Round-trips only; must be >= 0. */
+                    trip_duration_min?: components["parameters"]["tripDurationMin"];
+                    /** @description Maximum trip length in nights (must be >= trip_duration_min). */
+                    trip_duration_max?: components["parameters"]["tripDurationMax"];
+                    /** @description Minimum advance-purchase window in days (dep_date − search_date): searches made at least this many days before departure. Must be >= 0. */
+                    search_window_min?: components["parameters"]["searchWindowMin"];
+                    /** @description Maximum advance-purchase window in days (must be >= search_window_min). */
+                    search_window_max?: components["parameters"]["searchWindowMax"];
+                    /** @description Number of buckets N in the chosen granularity's own unit (min 2; max depends on granularity: day <= 60, week <= 52, month <= 12; default 12 applied server-side). The series spans the last N complete buckets, excluding the in-progress one. */
+                    trend_window?: components["parameters"]["trendWindow"];
+                    /** @description Bucket size for the returned series: week (default), day, or month. */
+                    granularity?: components["parameters"]["granularity"];
+                    /** @description Trend endpoints: maximum number of series (top-N keys). Default 10, max 50. */
+                    limit?: components["parameters"]["trendLimit"];
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Per-segment time series */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["TrendResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Validation error */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/health": {
         parameters: {
             query?: never;
@@ -3204,8 +3532,6 @@ export interface components {
             last_name?: string;
         };
         /** @enum {string} */
-        AnalysisType: "snapshot" | "trend";
-        /** @enum {string} */
         TravelPeriod: "Summer" | "Winter" | "Christmas" | "Easter" | "Next30Days" | "Next90Days" | "Custom";
         /** @enum {string} */
         TravelerType: "Solo" | "Couple" | "Group" | "Family";
@@ -3216,51 +3542,114 @@ export interface components {
             destination: string;
             /** Format: double */
             share?: number;
-            /**
-             * Format: double
-             * @description Growth % in trend mode (analysis=trend); omitted in snapshot.
-             */
-            growth?: number;
         };
         MarketRow: {
             rank?: number;
             market: string;
             /** Format: double */
             share?: number;
-            /**
-             * Format: double
-             * @description Growth % in trend mode (analysis=trend); omitted in snapshot.
-             */
-            growth?: number;
         };
         AudienceRow: {
             rank?: number;
             audience: string;
             /** Format: double */
             share?: number;
-            /**
-             * Format: double
-             * @description Growth % in trend mode (analysis=trend); omitted in snapshot.
-             */
-            growth?: number;
         };
         DestinationResponse: {
-            analysis_type: components["schemas"]["AnalysisType"];
             rows: components["schemas"]["DestinationRow"][];
         };
         MarketResponse: {
-            analysis_type: components["schemas"]["AnalysisType"];
             rows: components["schemas"]["MarketRow"][];
         };
         AudienceResponse: {
-            analysis_type: components["schemas"]["AnalysisType"];
             rows: components["schemas"]["AudienceRow"][];
         };
+        /**
+         * @description Bucket size for a trend series: week (default), day, or month.
+         * @enum {string}
+         */
+        Granularity: "day" | "week" | "month";
+        TrendPoint: {
+            /**
+             * Format: date
+             * @description Bucket start date (YYYY-MM-DD).
+             * @example 2026-06-20
+             */
+            date: string;
+            /**
+             * Format: double
+             * @description De-sampled search volume for the bucket.
+             * @example 1234
+             */
+            value: number;
+        };
+        /** @description Per-series rollup over the returned window. */
+        SeriesSummary: {
+            /**
+             * Format: double
+             * @example 34567
+             */
+            total?: number;
+            /**
+             * Format: double
+             * @example 1191
+             */
+            avg_per_day?: number;
+            /**
+             * Format: double
+             * @description Within-window growth %: recent half vs. prior half. Null when the prior half is empty.
+             * @example 12.3
+             */
+            growth_pct?: number | null;
+            /**
+             * Format: date
+             * @example 2026-06-14
+             */
+            peak_date?: string;
+            /**
+             * Format: double
+             * @example 1890
+             */
+            peak_value?: number;
+        };
+        TrendSeries: {
+            /**
+             * @description Ranked dimension value (destination/market/audience endpoints); omitted for the pairs endpoint.
+             * @example Country:FR
+             */
+            label?: string;
+            /**
+             * @description Pairs endpoint only: the origin selector for this series.
+             * @example Country:US
+             */
+            origin?: string;
+            /**
+             * @description Pairs endpoint only: the destination selector for this series.
+             * @example Country:FR
+             */
+            destination?: string;
+            series: components["schemas"]["TrendPoint"][];
+            summary?: components["schemas"]["SeriesSummary"];
+        };
+        TrendResponse: {
+            granularity: components["schemas"]["Granularity"];
+            /**
+             * Format: date
+             * @description First (inclusive) bucket date of the window.
+             * @example 2026-06-19
+             */
+            from: string;
+            /**
+             * Format: date
+             * @description Last (inclusive) bucket date of the window.
+             * @example 2026-06-25
+             */
+            to: string;
+            series: components["schemas"]["TrendSeries"][];
+        };
     };
     responses: never;
     parameters: {
-        /** @description Analysis mode. `trend` is accepted but currently returns snapshot-shaped data. */
-        analysis: components["schemas"]["AnalysisType"];
         /** @description Origin market filter as <Level>:<Code>, e.g. Country:US or City:NYC. */
         originMarket: string;
         /** @description Optional destination filter as <Level>:<Code>, e.g. Country:TH. */
@@ -3285,12 +3674,20 @@ export interface components {
         searchWindowMin: number;
         /** @description Maximum advance-purchase window in days (must be >= search_window_min). */
         searchWindowMax: number;
-        /** @description Snapshot mode only: number of most-recent days of search activity aggregated into the demand level (min 2, default 7, max 90 — a 1-day window is the current day, whose data is incomplete; the cube retains 90 days). Rejected when analysis=trend. */
+        /** @description Number of most-recent days of search activity aggregated into the demand level (min 2, default 7, max 90 — a 1-day window is the current day, whose data is incomplete; the cube retains 90 days). */
         snapshotWindowDays: number;
-        /** @description Trend mode only: size in days of each of the two adjacent windows compared for growth (min 2, default 7, max 45 — a 1-day window's recent period is the current day, whose data is incomplete; a trend spans 2x the window within the cube's 90-day retention). Rejected when analysis=snapshot. */
-        trendWindowDays: number;
         /** @description Max rows (1-200, default 20). */
         limit: number;
+        /** @description Pairs endpoint: comma-separated origin selectors `<Level>:<Code>` (e.g. `Country:US,Country:CA`). v1: at most one of origins/destinations may have more than one entry. */
+        origins: string;
+        /** @description Pairs endpoint: comma-separated destination selectors `<Level>:<Code>` (e.g. `Country:FR,Country:DE`). */
+        destinations: string;
+        /** @description Number of buckets N in the chosen granularity's own unit (min 2; max depends on granularity: day <= 60, week <= 52, month <= 12; default 12 applied server-side). The series spans the last N complete buckets, excluding the in-progress one. */
+        trendWindow: number;
+        /** @description Bucket size for the returned series: week (default), day, or month. */
+        granularity: components["schemas"]["Granularity"];
+        /** @description Trend endpoints: maximum number of series (top-N keys). Default 10, max 50. */
+        trendLimit: number;
     };
     requestBodies: never;
     headers: never;